ConnexionS'inscrire

API entreprise

API REST versionnée pour sync ERP. Authentifiez avec Authorization: Bearer gcn_live_… ou gcn_test_…. Créez des clés dans le tableau de bord Business.

Nouveau ? Commencez par la checklist onboarding partenaire.

URL de base

/api/v1

OpenAPI lisible machine : /api/v1/openapi

Collection Postman : Télécharger / importer

Points de terminaison principaux

  • 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

Les nouvelles clés reçoivent tous les scopes. Restriction fine via le modèle de données.

  • 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

Démarrage partenaire

Exemples curl pas à pas pour sync catalogue (tous modules), demandes et webhooks :

docs/api-partner-guide.md

Sonde de disponibilité : /api/v1/ready

Notes

  • Orgs non vérifiées : les créations restent PENDING jusqu'à approbation admin.
  • Orgs vérifiées : créations/mises à jour API publiées ACTIVE automatiquement.
  • Utilisez externalId + Idempotency-Key pour des retries ERP sûrs.
  • Bulk max 200 éléments/requête ; webhooks jusqu'à 3 tentatives avec backoff.
  • Webhooks signés HMAC (x-gcn-signature, x-gcn-timestamp).

Vérification…