API Enterprise

API REST versionat pentru sincronizarea ERP. Autentifică-te cu Authorization: Bearer gcn_live_… sau gcn_test_…. Creează chei în tabloul de bord al afacerii tale.

Nou aici? Începe cu lista de verificare pentru integrarea partenerilor.

URL de bază

/api/v1

OpenAPI citibil de mașină: /api/v1/openapi

Colecție Postman: Descarcă / importă

Puncte finale de bază

GET /me — org + scope-uri
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-uri

Cheile noi primesc toate scope-urile. Restricția detaliată este disponibilă prin modelul de date.

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

Ghid rapid pentru parteneri

Exemple curl pas cu pas pentru sincronizarea catalogului (toate modulele), cereri și webhook-uri:

docs/api-partner-guide.md

Probe de disponibilitate: /api/v1/ready

Note

Orgs neverificate: creațiile rămân PENDING până când administratorul aprobă.
Verificate orgs: API-ul creează/actualizează auto-publicarea ca ACTIVE.
Folosește externalId + Idempotency-Key pentru retry-uri ERP sigure.
Maxim 200 articole/cerere; webhook-urile retry până la 3 ori cu backoff.
Webhook-urile sunt semnate HMAC (x-gcn-signature, x-gcn-timestamp).