Enterprise API

Versie-gebaseerde REST API voor ERP-synchronisatie. Authenticeer met Authorization: Bearer gcn_live_… of gcn_test_…. Maak sleutels aan in je Business dashboard.

Nieuw hier? Begin met de partner onboarding checklist.

Basis URL

/api/v1

Machine-leesbare OpenAPI: /api/v1/openapi

Postman collectie: Downloaden / importeren

Kern eindpunten

GET /me — organisatie + 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

Nieuwe sleutels ontvangen alle scopes. Fijnmazige beperking is beschikbaar via het datamodel.

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 quickstart

Stap-voor-stap curl voorbeelden voor catalogus synchronisatie (alle modules), aanvragen en webhooks:

docs/api-partner-guide.md

Readiness probe: /api/v1/ready

Notities

Ongeloofwaardige organisaties: aanmaken blijft PENDING totdat de admin goedkeurt.
Geverifieerde organisaties: API maakt/bijwerkt automatisch publiceren als ACTIVE.
Gebruik externalId + Idempotency-Key voor veilige ERP-herhalingen.
Bulk maximaal 200 items/verzoek; webhooks proberen tot 3 keer met backoff.
Webhooks zijn HMAC-ondertekend (x-gcn-signature, x-gcn-timestamp).