Entwicklerplattform

Die FabHub-Entwicklerdokumentation ist der kanonische öffentliche Einstiegspunkt für die API, das SDK, MCP-Tools, Webhooks, die Authentifizierung und das Referenzmaterial zum Vertrag. Alles hier beschreibt die öffentliche Oberfläche, die unter https://api.fabhub.app/v1 bereitgestellt wird.

Was verfügbar ist

Öffentliche REST-API unter https://api.fabhub.app/v1, beschrieben durch OpenAPI.
Offizielles TypeScript-SDK (@fabhub/sdk) für typisierte serverseitige Integrationen.
Kuratierter MCP-Server (@fabhub/mcp), dessen Tools eins-zu-eins auf öffentliche API-Scopes abgebildet werden.
Signierte ausgehende Webhooks mit einem generierten AsyncAPI-Ereignisvertrag.
API-Schlüssel für mandanteneigene Automatisierung und OAuth für genehmigte Partneranwendungen.

Konventionen

Basis-URL: https://api.fabhub.app/v1. Jeder Pfad in dieser Referenz ist relativ dazu.
Format: Anfrage- und Antwort-Bodies sind JSON; Anfrage-Bodies verwenden camelCase-Schlüssel.
Query-Parameter verwenden snake_case (zum Beispiel page_size, contact_types).
IDs sind UUID-Strings. Zeitstempel sind ISO 8601 in UTC (zum Beispiel 2026-06-20T09:30:00Z).
Authentifizierung: Senden Sie einen API-Schlüssel im X-API-Key-Header (oder Authorization: Bearer). Siehe Authentifizierung.
Geldfelder (salePrice, purchasePrice) sind Zahlen in der Basiswährung des Mandanten oder null.

Kernkonzepte

Tenant: jede Anmeldeinformation gehört zu einem Tenant (Organisation); alle Daten sind mandantengebunden.
Scopes: Schlüssel tragen Scopes nach dem Least-Privilege-Prinzip wie items:read oder webhooks:write.
Idempotenz: Schreibanfragen nehmen einen Idempotency-Key entgegen, sodass Wiederholungen sicher sind. Siehe Idempotenz.
Paginierung: Listen sind seitenbasiert; der Audit-Export ist cursorbasiert. Siehe Paginierung.
Fehler: eine stabile JSON-Hülle mit einem maschinenlesbaren code. Siehe Fehler.

Aktueller Vertrags-Snapshot

OpenAPI-Version: 1.0.0
Öffentliche Operationen: 47
Öffentliche Scopes: 15
Webhook-Kanäle: 14
MCP-Tools: 45

Hier starten

Herunterladbare Verträge

Öffentlich freigegebene Quelldokumente

Das Portal wird aus öffentlich freigegebenen Quellen der Entwicklerplattform generiert, die in docs/developer-platform/docs-source-registry.json registriert sind:

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

Was verfügbar ist

Öffentliche REST-API unter https://api.fabhub.app/v1, beschrieben durch OpenAPI.

Offizielles TypeScript-SDK (@fabhub/sdk) für typisierte serverseitige Integrationen.

Kuratierter MCP-Server (@fabhub/mcp), dessen Tools eins-zu-eins auf öffentliche API-Scopes abgebildet werden.

Signierte ausgehende Webhooks mit einem generierten AsyncAPI-Ereignisvertrag.

API-Schlüssel für mandanteneigene Automatisierung und OAuth für genehmigte Partneranwendungen.

Konventionen

Basis-URL: https://api.fabhub.app/v1. Jeder Pfad in dieser Referenz ist relativ dazu.

Format: Anfrage- und Antwort-Bodies sind JSON; Anfrage-Bodies verwenden camelCase-Schlüssel.

Query-Parameter verwenden snake_case (zum Beispiel page_size, contact_types).

IDs sind UUID-Strings. Zeitstempel sind ISO 8601 in UTC (zum Beispiel 2026-06-20T09:30:00Z).

Authentifizierung: Senden Sie einen API-Schlüssel im X-API-Key-Header (oder Authorization: Bearer). Siehe Authentifizierung.

Geldfelder (salePrice, purchasePrice) sind Zahlen in der Basiswährung des Mandanten oder null.

Kernkonzepte

Tenant: jede Anmeldeinformation gehört zu einem Tenant (Organisation); alle Daten sind mandantengebunden.

Scopes: Schlüssel tragen Scopes nach dem Least-Privilege-Prinzip wie items:read oder webhooks:write.

Idempotenz: Schreibanfragen nehmen einen Idempotency-Key entgegen, sodass Wiederholungen sicher sind. Siehe Idempotenz.

Paginierung: Listen sind seitenbasiert; der Audit-Export ist cursorbasiert. Siehe Paginierung.

Fehler: eine stabile JSON-Hülle mit einem maschinenlesbaren code. Siehe Fehler.

Öffentlich freigegebene Quelldokumente

Das Portal wird aus öffentlich freigegebenen Quellen der Entwicklerplattform generiert, die in docs/developer-platform/docs-source-registry.json registriert sind:

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