حدود المعدل والحصص

يخضع استخدام API لـ حدود معدل لكل دقيقة وحصص يومية لكل قناة (وحدات قابلة للفوترة). تحدد الحدود أثناء تهيئة التطبيق بناء على حجم المعاملات المتوقع — راجع الاستخدام المقبول.

الحدود والترويسات المنظمة: data/rate-limits.json.

حد المعدل لكل دقيقة {#rate-limits}

الافتراضي: 60 طلبا/دقيقة لكل مفتاح API (حسب الخطة). عند التجاوز → HTTP 429 مع RATE_LIMIT_EXCEEDED.

حصة القناة اليومية (وحدات قابلة للفوترة) {#daily-quota}

تستهلك مسارات كثيرة وحدات قابلة للفوترة من حد يومي لكل قناة (1688, Taobao). أمثلة:

المسار	الوحدات المعتادة
POST /v1/products/detail	1
POST /v1/products/search	2
POST /v1/products/upload-image	2
POST /v1/orders/preview, create	وزن أعلى — راجع الخطة

عند استنفاد الحد اليومي → HTTP 429 مع QUOTA_EXCEEDED. تواصل مع HIOBuy لرفع الحدود مع نمو GMV.

ترويسات الاستجابة {#response-headers}

قد تتضمن الاستدعاءات القابلة للفوترة الناجحة:

Header	الوصف
X-Quota-Billable-Units	الوحدات التي استهلكها هذا الطلب
X-Quota-Channel	القناة التي احتسبت عليها الوحدات (مثل 1688)
x-request-id	معرف ربط الطلب (كل المسارات)

سعة المنصة {#platform-quota}

نادرا ما تكون سعة upstream المشتركة غير متاحة مؤقتا → PLATFORM_QUOTA_EXCEEDED (429). أعد المحاولة لاحقا أو تواصل مع الدعم.

توصيات للعميل {#handling}

• خزّن استجابات تفاصيل المنتج مؤقتا حيث تسمح قواعد العمل.
• فضل إعادة استخدام image_id بعد upload-image بدلا من الرفع مجددا.
• استخدم backoff عند 429؛ واقرأ error.request_id — راجع الأخطاء.
• راقب الاستخدام في لوحة استخدام بوابة المطورين.