Kurumsal API

ERP senkronizasyonu için sürümlü REST API. Authorization: Bearer gcn_live_… veya gcn_test_… ile kimlik doğrulayın. İşletme panelinizde anahtarlar oluşturun.

Burada yeni misiniz? ortak onboarding kontrol listesini kullanarak başlayın.

Temel URL

/api/v1

Makine okunabilir OpenAPI: /api/v1/openapi

Postman koleksiyonu: İndir / içe aktar

Temel uç noktalar

GET /me — org + kapsamlar
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}

Kapsamlar

Yeni anahtarlar tüm kapsamları alır. İnce ayar kısıtlaması veri modeli aracılığıyla mevcuttur.

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

Ortak hızlı başlangıç

Katalog senkronizasyonu (tüm modüller), sorgular ve web kancaları için adım adım curl örnekleri:

docs/api-partner-guide.md

Hazırlık testi: /api/v1/ready

Notlar

Doğrulanmamış organizasyonlar: oluşturulanlar PENDING olarak kalır, ta ki yönetici onaylayana kadar.
Doğrulanmış organizasyonlar: API, otomatik yayın oluşturur/günceller ve ACTIVE olarak işaretler.
Güvenli ERP tekrarları için externalId + Idempotency-Key kullanın.
Toplu en fazla 200 öğe/istek; web kancaları geri dönüşüm için 3 kez deneme yapar.
Web kancaları HMAC ile imzalanmıştır (x-gcn-signature, x-gcn-timestamp).