AccediRegistrati

API enterprise

API REST versionata per sync ERP. Autenticati con Authorization: Bearer gcn_live_… o gcn_test_…. Crea chiavi nella dashboard Business.

Nuovo? Inizia dalla checklist onboarding partner.

URL di base

/api/v1

OpenAPI machine-readable: /api/v1/openapi

Collection Postman: Scarica / importa

Endpoint principali

  • 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}

Scope

Le nuove chiavi ricevono tutti gli scope. Restrizione fine tramite il data model.

  • 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

Avvio rapido partner

Esempi curl passo-passo per sync catalogo (tutti i moduli), richieste e webhook:

docs/api-partner-guide.md

Probe di readiness: /api/v1/ready

Note

  • Org non verificate: le create restano PENDING fino all'approvazione admin.
  • Org verificate: create/update API pubblicate ACTIVE automaticamente.
  • Usa externalId + Idempotency-Key per retry ERP sicuri.
  • Bulk max 200 item/richiesta; webhook fino a 3 retry con backoff.
  • Webhook firmati HMAC (x-gcn-signature, x-gcn-timestamp).

Controllo…