تسجيل الدخولإنشاء حساب

واجهة برمجة المؤسسات

REST API بإصدارات لمزامنة ERP. المصادقة عبر Authorization: Bearer gcn_live_… أو gcn_test_…. أنشئ المفاتيح من لوحة Business.

جديد هنا؟ ابدأ بقائمة إعداد الشركاء.

عنوان الأساس

/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

بدء سريع للشركاء

أمثلة curl خطوة بخطوة لمزامنة الكتالوج (كل الوحدات) والاستفسارات وwebhooks:

docs/api-partner-guide.md

فحص الجاهزية: /api/v1/ready

ملاحظات

  • منظمات غير موثّقة: تبقى الإنشاءات PENDING حتى موافقة المشرف.
  • منظمات موثّقة: تنشر إنشاءات/تحديثات API كـ ACTIVE تلقائياً.
  • استخدم externalId + Idempotency-Key لإعادة محاولات ERP بأمان.
  • الحد الأقصى للدفعة 200 عنصر/طلب؛ webhooks حتى 3 إعادة مع backoff.
  • webhooks موقّعة HMAC (x-gcn-signature، x-gcn-timestamp).

جارٍ التحقق…