Plateforme développeur

La documentation développeur de FabHub est le point d'entrée public canonique pour l'API, le SDK, les outils MCP, les webhooks, l'authentification et la documentation de référence des contrats. Tout ce qui figure ici décrit la surface publique servie depuis https://api.fabhub.app/v1.

Ce qui est disponible

API REST publique sur https://api.fabhub.app/v1, décrite par OpenAPI.
SDK TypeScript officiel (@fabhub/sdk) pour des intégrations typées côté serveur.
Serveur MCP organisé (@fabhub/mcp) dont les outils correspondent un à un aux scopes de l'API publique.
Webhooks sortants signés avec un contrat d'événements AsyncAPI généré.
Clés API pour l'automatisation appartenant au tenant et OAuth pour les applications partenaires approuvées.

Conventions

URL de base : https://api.fabhub.app/v1. Chaque chemin de cette référence y est relatif.
Format : les corps de requête et de réponse sont en JSON ; les corps de requête utilisent des clés en camelCase.
Les paramètres de requête utilisent le snake_case (par exemple page_size, contact_types).
Les identifiants sont des chaînes UUID. Les horodatages sont au format ISO 8601 en UTC (par exemple 2026-06-20T09:30:00Z).
Authentification : envoyez une clé API dans l'en-tête X-API-Key (ou Authorization: Bearer). Voir Authentification.
Les champs monétaires (salePrice, purchasePrice) sont des nombres dans la devise de base du tenant, ou null.

Concepts fondamentaux

Tenant: chaque identifiant appartient à un seul tenant (organisation) ; toutes les données sont cantonnées au tenant.
Scopes: les clés portent des scopes au moindre privilège tels que items:read ou webhooks:write.
Idempotence: les requêtes en écriture acceptent un Idempotency-Key afin que les nouvelles tentatives soient sûres. Voir Idempotence.
Pagination: les listes sont paginées par page ; l'export d'audit est paginé par curseur. Voir Pagination.
Erreurs: une enveloppe JSON stable avec un code exploitable par machine. Voir Erreurs.

Instantané du contrat actuel

Version OpenAPI : 1.0.0
Opérations publiques : 47
Scopes publics : 15
Canaux de webhooks : 14
Outils MCP : 45

Commencez ici

Contrats téléchargeables

Documents sources publiquement diffusables

Le portail est généré à partir de sources de plateforme développeur publiquement diffusables enregistrées dans 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

Ce qui est disponible

API REST publique sur https://api.fabhub.app/v1, décrite par OpenAPI.

SDK TypeScript officiel (@fabhub/sdk) pour des intégrations typées côté serveur.

Serveur MCP organisé (@fabhub/mcp) dont les outils correspondent un à un aux scopes de l'API publique.

Webhooks sortants signés avec un contrat d'événements AsyncAPI généré.

Clés API pour l'automatisation appartenant au tenant et OAuth pour les applications partenaires approuvées.

Conventions

URL de base : https://api.fabhub.app/v1. Chaque chemin de cette référence y est relatif.

Format : les corps de requête et de réponse sont en JSON ; les corps de requête utilisent des clés en camelCase.

Les paramètres de requête utilisent le snake_case (par exemple page_size, contact_types).

Les identifiants sont des chaînes UUID. Les horodatages sont au format ISO 8601 en UTC (par exemple 2026-06-20T09:30:00Z).

Authentification : envoyez une clé API dans l'en-tête X-API-Key (ou Authorization: Bearer). Voir Authentification.

Les champs monétaires (salePrice, purchasePrice) sont des nombres dans la devise de base du tenant, ou null.

Concepts fondamentaux

Tenant: chaque identifiant appartient à un seul tenant (organisation) ; toutes les données sont cantonnées au tenant.

Scopes: les clés portent des scopes au moindre privilège tels que items:read ou webhooks:write.

Idempotence: les requêtes en écriture acceptent un Idempotency-Key afin que les nouvelles tentatives soient sûres. Voir Idempotence.

Pagination: les listes sont paginées par page ; l'export d'audit est paginé par curseur. Voir Pagination.

Erreurs: une enveloppe JSON stable avec un code exploitable par machine. Voir Erreurs.

Documents sources publiquement diffusables

Le portail est généré à partir de sources de plateforme développeur publiquement diffusables enregistrées dans 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