ログイン新規登録

エンタープライズAPI

ERP同期用のバージョン付きREST API。Authorization: Bearer gcn_live_… または gcn_test_… で認証。Businessダッシュボードでキーを作成。

初めてですか？パートナー・オンボーディングから始めてください。

ベースURL

/api/v1

機械可読OpenAPI： /api/v1/openapi

Postmanコレクション： ダウンロード / インポート

主要エンドポイント

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

スコープ

新しいキーは全スコープを受け取ります。データモデルで細かく制限可能です。

  • 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

パートナークイックスタート

カタログ同期（全モジュール）、問い合わせ、Webhookのcurl例：

docs/api-partner-guide.md

Readyプローブ： /api/v1/ready

注意

  • 未検証組織：作成は管理者承認までPENDINGのままです。
  • 検証済み組織：API作成/更新は自動でACTIVE公開されます。
  • 安全なERPリトライのためexternalId + Idempotency-Keyを使用。
  • Bulkは最大200件/リクエスト。Webhookは最大3回バックオフ再試行。
  • WebhookはHMAC署名（x-gcn-signature、x-gcn-timestamp）。

確認中…