MasukDaftar

API Perusahaan

API REST versi untuk sinkronisasi ERP. Autentikasi dengan Authorization: Bearer gcn_live_… atau gcn_test_…. Buat kunci di dasbor Bisnis Anda.

Baru di sini? Mulai dengan daftar periksa onboarding mitra.

URL Dasar

/api/v1

OpenAPI yang dapat dibaca mesin: /api/v1/openapi

Koleksi Postman: Unduh / impor

Endpoint inti

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

Lingkup

Kunci baru menerima semua lingkup. Pembatasan yang lebih halus tersedia melalui model data.

  • 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

Panduan cepat mitra

Contoh curl langkah-demi-langkah untuk sinkronisasi katalog (semua modul), permintaan dan webhook:

docs/api-partner-guide.md

Probe kesiapan: /api/v1/ready

Catatan

  • Organisasi yang belum diverifikasi: pembuatan tetap PENDING hingga disetujui oleh admin.
  • Diverifikasi organisasi: API membuat/memperbarui publikasi otomatis sebagai ACTIVE.
  • Gunakan externalId + Idempotency-Key untuk percobaan ERP yang aman.
  • Maksimal 200 item/permintaan; webhook mencoba kembali hingga 3 kali dengan penundaan.
  • Webhook ditandatangani HMAC (x-gcn-signature, x-gcn-timestamp).

Memeriksa…