المصادقة

تتطلب جميع طلبات Public API رمز Bearer. تتم إدارة بيانات اعتماد القنوات وأكواد المستودعات في بوابة المطورين — لا تضمنها أبدا داخل تطبيقات العملاء.

مفاتيح API {#api-keys}

أنشئ المفاتيح من Developer Portal → API Keys بعد اعتماد تطبيقك.

مثال طلب

curl https://api.hiobuy.com/v1/products/detail \
  -H "Authorization: Bearer hio_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "1688",
    "product_id": "554456348334",
    "language": "en"
  }'

تفويض القنوات (متطلب مسبق) {#channel-authorization}

مفتاح API وحده لا يكفي. يجب أن يكمل كل تطبيق تفويض القناة قبل استدعاء واجهات المنتجات أو الطلبات الخاصة بذلك السوق.

راجع تفويض البوابة. إذا لم تكن القناة مفوضة، تعيد الاستدعاءات 401 CHANNEL_NOT_AUTHORIZED (الأخطاء).

ما لا ترسله أبدا {#what-not-to-send}

• رموز وصول أو تحديث Taobao / 1688 / Weidian
• كود مطور المستودع (يضيفه Gateway لمسارات fulfillment)
• Portal session JWT في استدعاءات Public API

تتبع الطلبات {#tracing}

تتضمن كل استجابة:

• ترويسة x-request-id — لربطها مع request_id في جسم JSON
• ترويسات حصة اختيارية على المسارات القابلة للفوترة — راجع حدود المعدل

أرفق x-request-id عند التواصل مع دعم HIOBuy.

أخطاء المصادقة الشائعة {#auth-errors}