تفويض البوابة
بعد اعتماد تطبيقك، فوّض القنوات في بوابة المطورين قبل استدعاء واجهات procurement أو fulfillment.
هناك طبقتان من الاختيار:
- Fulfillment mode — هل يخزّن HioBuy ويشحن دولياً
- Procurement mode (فقط عند تفعيل warehouse fulfillment) — من يشتري على Taobao / 1688 / Weidian
Fulfillment mode (لكل تطبيق)
| الوضع | من يحتفظ بـ warehouse binding | الشحن الدولي (/v1/fulfillment/*) |
|---|---|---|
| Self fulfillment (الافتراضي) | لا أحد — أنت تتولى اللوجستيات بنفسك | غير متاح (403) |
| HioBuy warehouse | كود مطور مستودع واحد | متاح — Fulfillment overview |
مسارات Public API تبقى كما هي (/v1/products/*, /v1/orders/*, …). يوجّه Gateway حسب أوضاع تطبيقك.
Procurement ضمن warehouse fulfillment
عند اختيار HioBuy warehouse، يدعم procurement خيارين. التخزين والشحن الدولي يعملان في كليهما؛ يختلف فقط من يضع أوامر الشراء على marketplace.
| Procurement mode | من يشتري على marketplace | Channel tokens | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy procurement (الافتراضي) | HioBuy يشتري نيابةً عنك | تُصدر عبر warehouse authorize؛ يخزّنها Gateway | تُوجَّه عبر HioBuy warehouse procurement | Gateway يستخدم الرموز المخزّنة → marketplace |
| Self procurement | أنت تشتري بحساباتك الخاصة | تدير OAuth / credentials في البوابة | Gateway → marketplace برموزك (نفس تدفق self الكلاسيكي) | نفسه — رموزك |
| القدرة | HioBuy procurement | Self procurement |
|---|---|---|
| ربط warehouse code مرة واحدة | نعم | نعم |
| Warehouse inbound / packages / VAS / returns | نعم | نعم |
| International shipments & wallet | نعم | نعم |
| إدارة Marketplace OAuth بنفسك | لا | نعم (لكل قناة) |
التبديل بين خياري procurement قد يمسح أو يعيد إصدار channel tokens؛ ستطلب منك البوابة التأكيد.
Self fulfillment (بدون مستودع HioBuy)
لكل قناة مفعّلة (Taobao, 1688, Weidian, …):
- افتح Authorizations → اختر التطبيق → Authorize
- الصق بيانات OAuth أو أكمل OAuth عندما يكون متاحاً
- تعرض البوابة الحالة واسم الحساب والانتهاء — وليس الرموز الكاملة أبداً
/v1/fulfillment/* غير متاح في هذا الوضع.
HioBuy warehouse fulfillment (الإعداد)
- احصل على warehouse developer code من عمليات HioBuy
- Portal → Authorizations → اختر Use HioBuy fulfillment
- اختر procurement mode: HioBuy procurement أو self procurement
- أدخل كود المستودع مرة واحدة — الربط على مستوى التطبيق (وليس لكل قناة)
- إذا HioBuy procurement: تعرض البوابة حالة كل قناة و
expires_at(الرموز غير مرئية وغير قابلة للتحرير) - إذا self procurement: أكمل بنفسك OAuth / إدخال credentials لكل قناة كالمعتاد؛ ربط المستودع يفتح فقط واجهات fulfillment
الرجوع إلى self fulfillment يمسح ربط المستودع؛ سيُطلب منك التأكيد.
ما لا ترسله أبداً في استدعاءات API
- Marketplace access tokens
- Warehouse developer code (يضيفه Gateway من جهة الخادم)
فقط Authorization: Bearer hio_live_… (أو hio_test_…) على https://api.hiobuy.com.
التالي: Fulfillment overview · Orders
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days