Plataforma para desarrolladores

La documentación para desarrolladores de FabHub es el punto de entrada público canónico para la API, el SDK, las herramientas MCP, los webhooks, la autenticación y el material de referencia del contrato. Todo lo que aquí se describe corresponde a la superficie pública servida desde https://api.fabhub.app/v1.

Qué está disponible

API REST pública en https://api.fabhub.app/v1, descrita mediante OpenAPI.
SDK oficial de TypeScript (@fabhub/sdk) para integraciones tipadas del lado del servidor.
Servidor MCP curado (@fabhub/mcp) cuyas herramientas se mapean uno a uno con los scopes de la API pública.
Webhooks salientes firmados con un contrato de eventos AsyncAPI generado.
API keys para automatización propiedad del tenant y OAuth para aplicaciones de partners aprobadas.

Convenciones

URL base: https://api.fabhub.app/v1. Toda ruta de esta referencia es relativa a ella.
Formato: los cuerpos de petición y respuesta son JSON; los cuerpos de petición usan claves camelCase.
Los parámetros de consulta usan snake_case (por ejemplo page_size, contact_types).
Los IDs son cadenas UUID. Las marcas de tiempo son ISO 8601 en UTC (por ejemplo 2026-06-20T09:30:00Z).
Autenticación: envía una API key en la cabecera X-API-Key (o Authorization: Bearer). Consulta Autenticación.
Los campos monetarios (salePrice, purchasePrice) son números en la moneda base del tenant, o null.

Conceptos clave

Tenant: cada credencial pertenece a un tenant (organización); todos los datos tienen scope de tenant.
Scopes: las keys llevan scopes de mínimo privilegio como items:read o webhooks:write.
Idempotencia: las peticiones de escritura aceptan una Idempotency-Key para que los reintentos sean seguros. Consulta Idempotencia.
Paginación: los listados se paginan por página; la exportación de auditoría se pagina por cursor. Consulta Paginación.
Errores: un sobre JSON estable con un code legible por máquina. Consulta Errores.

Instantánea actual del contrato

Versión de OpenAPI: 1.0.0
Operaciones públicas: 47
Scopes públicos: 15
Canales de webhook: 14
Herramientas MCP: 45

Empieza aquí

Contratos descargables

Documentos fuente seguros para el público

El portal se genera a partir de fuentes de la plataforma para desarrolladores seguras para el público registradas en docs/developer-platform/docs-source-registry.json:

docs/developer-platform/api-changelog.md
docs/developer-platform/enterprise-controls.md
docs/developer-platform/hosted-mcp.md
docs/developer-platform/openapi-breaking-change-policy.md
docs/developer-platform/scope-taxonomy.md
docs/developer-platform/usage-endpoint.md
docs/developer-platform/webhook-events.md
docs/developer-platform/versioning-and-deprecation.md

Plataforma para desarrolladores

Qué está disponible

API REST pública en https://api.fabhub.app/v1, descrita mediante OpenAPI.

SDK oficial de TypeScript (@fabhub/sdk) para integraciones tipadas del lado del servidor.

Servidor MCP curado (@fabhub/mcp) cuyas herramientas se mapean uno a uno con los scopes de la API pública.

Webhooks salientes firmados con un contrato de eventos AsyncAPI generado.

API keys para automatización propiedad del tenant y OAuth para aplicaciones de partners aprobadas.

Convenciones

URL base: https://api.fabhub.app/v1. Toda ruta de esta referencia es relativa a ella.

Formato: los cuerpos de petición y respuesta son JSON; los cuerpos de petición usan claves camelCase.

Los parámetros de consulta usan snake_case (por ejemplo page_size, contact_types).

Los IDs son cadenas UUID. Las marcas de tiempo son ISO 8601 en UTC (por ejemplo 2026-06-20T09:30:00Z).

Autenticación: envía una API key en la cabecera X-API-Key (o Authorization: Bearer). Consulta Autenticación.

Los campos monetarios (salePrice, purchasePrice) son números en la moneda base del tenant, o null.

Conceptos clave

Tenant: cada credencial pertenece a un tenant (organización); todos los datos tienen scope de tenant.

Scopes: las keys llevan scopes de mínimo privilegio como items:read o webhooks:write.

Idempotencia: las peticiones de escritura aceptan una Idempotency-Key para que los reintentos sean seguros. Consulta Idempotencia.

Paginación: los listados se paginan por página; la exportación de auditoría se pagina por cursor. Consulta Paginación.

Errores: un sobre JSON estable con un code legible por máquina. Consulta Errores.

Documentos fuente seguros para el público

El portal se genera a partir de fuentes de la plataforma para desarrolladores seguras para el público registradas en docs/developer-platform/docs-source-registry.json:

docs/developer-platform/api-changelog.md

docs/developer-platform/enterprise-controls.md

docs/developer-platform/hosted-mcp.md

docs/developer-platform/openapi-breaking-change-policy.md

docs/developer-platform/scope-taxonomy.md

docs/developer-platform/usage-endpoint.md

docs/developer-platform/webhook-events.md

docs/developer-platform/versioning-and-deprecation.md