API องค์กร

URL หลัก

OpenAPI ที่เครื่องอ่านได้: /api/v1/openapi

คอลเลกชัน Postman: ดาวน์โหลด / นำเข้า

เอนด์พอยต์หลัก

• GET /me — องค์กร + ขอบเขตสิทธิ์
• 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 จำกัดละเอียดผ่าน data model ได้

• 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

เริ่มต้นเร็วสำหรับพาร์ทเนอร์

ตัวอย่าง curl ทีละขั้นสำหรับซิงก์แคตตาล็อก (ทุกโมดูล) คำถาม และ webhook:

โพรบความพร้อม: /api/v1/ready

หมายเหตุ

• องค์กรที่ยังไม่ยืนยัน: การสร้างอยู่ที่ PENDING จนกว่าแอดมินจะอนุมัติ
• องค์กรที่ยืนยันแล้ว: การสร้าง/อัปเดต API เผยแพร่ ACTIVE อัตโนมัติ
• ใช้ externalId + Idempotency-Key สำหรับรีทราย ERP ที่ปลอดภัย
• Bulk สูงสุด 200 รายการ/คำขอ webhook รีทรายสูงสุด 3 ครั้งพร้อม backoff
• Webhook ลงนาม HMAC (x-gcn-signature, x-gcn-timestamp)