Piattaforma per sviluppatori

La documentazione per sviluppatori di FabHub è il punto di ingresso pubblico canonico per l'API, l'SDK, gli strumenti MCP, i webhook, l'autenticazione e il materiale di riferimento sui contratti. Tutto ciò che trovi qui descrive la superficie pubblica servita da https://api.fabhub.app/v1.

Cosa è disponibile

API REST pubblica su https://api.fabhub.app/v1, descritta tramite OpenAPI.
SDK TypeScript ufficiale (@fabhub/sdk) per integrazioni server-side tipizzate.
Server MCP curato (@fabhub/mcp) i cui strumenti corrispondono uno a uno agli scope dell'API pubblica.
Webhook in uscita firmati con un contratto di eventi AsyncAPI generato.
Chiavi API per l'automazione di proprietà del tenant e OAuth per le applicazioni partner approvate.

Convenzioni

URL base: https://api.fabhub.app/v1. Ogni percorso in questo riferimento è relativo a esso.
Formato: i corpi di richiesta e risposta sono JSON; i corpi di richiesta usano chiavi camelCase.
I parametri di query usano snake_case (ad esempio page_size, contact_types).
Gli ID sono stringhe UUID. I timestamp sono in formato ISO 8601 in UTC (ad esempio 2026-06-20T09:30:00Z).
Autenticazione: invia una chiave API nell'header X-API-Key (oppure Authorization: Bearer). Vedi Autenticazione.
I campi monetari (salePrice, purchasePrice) sono numeri nella valuta base del tenant, oppure null.

Concetti fondamentali

Tenant: ogni credenziale appartiene a un tenant (organizzazione); tutti i dati sono limitati al tenant.
Scope: le chiavi portano scope a privilegio minimo come items:read o webhooks:write.
Idempotenza: le richieste di scrittura accettano un Idempotency-Key affinché i tentativi ripetuti siano sicuri. Vedi Idempotenza.
Paginazione: gli elenchi sono basati su pagine; l'esportazione di audit è basata su cursore. Vedi Paginazione.
Errori: un involucro JSON stabile con un code leggibile dalla macchina. Vedi Errori.

Snapshot attuale del contratto

Versione OpenAPI: 1.0.0
Operazioni pubbliche: 47
Scope pubblici: 15
Canali webhook: 14
Strumenti MCP: 45

Inizia da qui

Contratti scaricabili

Documenti sorgente sicuri per il pubblico

Il portale è generato da sorgenti della piattaforma per sviluppatori, sicure per il pubblico, registrate in 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

Cosa è disponibile

API REST pubblica su https://api.fabhub.app/v1, descritta tramite OpenAPI.

SDK TypeScript ufficiale (@fabhub/sdk) per integrazioni server-side tipizzate.

Server MCP curato (@fabhub/mcp) i cui strumenti corrispondono uno a uno agli scope dell'API pubblica.

Webhook in uscita firmati con un contratto di eventi AsyncAPI generato.

Chiavi API per l'automazione di proprietà del tenant e OAuth per le applicazioni partner approvate.

Convenzioni

URL base: https://api.fabhub.app/v1. Ogni percorso in questo riferimento è relativo a esso.

Formato: i corpi di richiesta e risposta sono JSON; i corpi di richiesta usano chiavi camelCase.

I parametri di query usano snake_case (ad esempio page_size, contact_types).

Gli ID sono stringhe UUID. I timestamp sono in formato ISO 8601 in UTC (ad esempio 2026-06-20T09:30:00Z).

Autenticazione: invia una chiave API nell'header X-API-Key (oppure Authorization: Bearer). Vedi Autenticazione.

I campi monetari (salePrice, purchasePrice) sono numeri nella valuta base del tenant, oppure null.

Concetti fondamentali

Tenant: ogni credenziale appartiene a un tenant (organizzazione); tutti i dati sono limitati al tenant.

Scope: le chiavi portano scope a privilegio minimo come items:read o webhooks:write.

Idempotenza: le richieste di scrittura accettano un Idempotency-Key affinché i tentativi ripetuti siano sicuri. Vedi Idempotenza.

Paginazione: gli elenchi sono basati su pagine; l'esportazione di audit è basata su cursore. Vedi Paginazione.

Errori: un involucro JSON stabile con un code leggibile dalla macchina. Vedi Errori.

Documenti sorgente sicuri per il pubblico

Il portale è generato da sorgenti della piattaforma per sviluppatori, sicure per il pubblico, registrate in 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