Enterprise-API

Versionierte REST-API für ERP-Sync. Authentifizierung mit Authorization: Bearer gcn_live_… oder gcn_test_…. Schlüssel im Business-Dashboard erstellen.

Neu hier? Starten Sie mit der Partner-Onboarding-Checkliste.

Basis-URL

/api/v1

Maschinenlesbares OpenAPI: /api/v1/openapi

Postman-Collection: Download / Import

Kern-Endpunkte

GET /me — Org + Scopes
GET|POST /listings, /listings/bulk
GET|POST /inventory, /inventory/bulk (syncMode: upsert|replace)
/freight, /freight/bulk · /depots, /depots/bulk · /storage, /storage/bulk · /manufacturers, /manufacturers/bulk · /ports, /ports/bulk
/inquiries, /inquiries/{id}/reply
/organization, /webhooks, /bulk/{jobId}

Scopes

Neue Schlüssel erhalten alle Scopes. Feingranulare Einschränkung ist über das Datenmodell möglich.

listings:read
listings:write
inventory:read
inventory:write
freight:read
freight:write
depots:read
depots:write
storage:read
storage:write
manufacturers:read
manufacturers:write
ports:read
ports:write
inquiries:read
inquiries:write
org:read
org:write
webhooks:manage
bulk:write

Partner-Schnellstart

Schritt-für-Schritt-curl-Beispiele für Katalog-Sync (alle Module), Anfragen und Webhooks:

docs/api-partner-guide.md

Bereitschaftsprüfung: /api/v1/ready

Hinweise

Nicht verifizierte Orgs: Anlagen bleiben PENDING bis zur Admin-Freigabe.
Verifizierte Orgs: API-Anlagen/Updates werden automatisch ACTIVE.
Nutzen Sie externalId + Idempotency-Key für sichere ERP-Retries.
Bulk max. 200 Positionen/Anfrage; Webhooks bis 3× mit Backoff.
Webhooks sind HMAC-signiert (x-gcn-signature, x-gcn-timestamp).