تساعدك هذه المقالة على البقاء ضمن حدود HueChat API وفهم ردود الأخطاء التي قد تراها. المرجع الكامل متاح في مركز المطورين على https://developers.huechat.ai.
| بيانات الاعتماد أو الواجهة | الحد |
|---|---|
| رمز الوصول الشخصي | 1,000 طلب في الدقيقة |
| مفتاح API محدود النطاق | الحد الخاص بالمفتاح، من 1 إلى 100,000 في الدقيقة (الافتراضي 1,000) |
مسارات الذكاء الاصطناعي ضمن /api/v2 |
دفعة من 10 طلبات، ثم طلب واحد كل ثانيتين |
الحدود محسوبة لكل دقيقة ولكل بيانات اعتماد. يُتسامح مع الدفعات القصيرة التي تتجاوز المعدل الدقيقي حتى نحو سدس الحد. كما تُحدّ الطلبات لكل عنوان IP، ويُسقف حجم جسم الطلب عند 20 ميجابايت.
يخبرك كل رد بموقعك من الحد:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1712345738
X-RateLimit-Reset هو طابع زمني بصيغة Unix لبداية النافذة التالية. راقب X-RateLimit-Remaining وأبطئ قبل أن يصل إلى الصفر.
تتلقى 429 Too Many Requests مع ترويسة Retry-After بالثواني وجسمًا مثل { "error": "Rate limit exceeded" }. انتظر مدة Retry-After، ثم تراجع أسيًا إذا تكرر الأمر. لا تعد المحاولة في حلقة متلاحقة؛ فذلك لا يفعل سوى إطالة الحظر.
للبقاء تحت الحد، استخدم استدعاء قائمة واحدًا محدودًا بدلًا من استطلاع كل سجل على حدة، وانقل العمل المعتمد على الأحداث إلى Webhooks (لا يكلف الاشتراك أي طلبات)، وأعطِ كل تكامل مفتاحه محدود النطاق الخاص به.
| الحالة | المعنى | السبب المعتاد |
|---|---|---|
400 |
طلب غير صالح | جسم أو معامل بصيغة خاطئة |
401 |
غير مصرح | بيانات اعتماد مفقودة أو غير صالحة، أو البادئة Bearer مفقودة |
403 |
ممنوع | الحساب في الرابط ليس حسابك، أو يفتقر المفتاح إلى نطاق، أو عنوان IP ليس في قائمة المسموح بها، أو دورك أدنى من المطلوب |
404 |
غير موجود | المعرّف غير موجود في حسابك |
422 |
تعذرت المعالجة | تم تحليل الجسم لكنه فشل في التحقق |
429 |
طلبات كثيرة جدًا | راجع حدود المعدل أعلاه |
500 |
خطأ في الخادم | تحقق من النتيجة قبل إعادة محاولة أي عملية كتابة؛ وتواصل مع الدعم إذا استمر |
تعيد معظم الأخطاء { "error": "..." }. وقد تتضمن أخطاء التحقق تفاصيل إضافية خاصة بنقطة الاتصال.
Authorization: Bearer <token>. يعيد الرمز المجرد 401.page=1. يثبت الرد 200 أن بيانات الاعتماد تعمل.403، تأكد من أن معرّف الحساب يخص المفتاح، وأن المسؤول الذي أنشأ المفتاح لا يزال يملك الوصول، وأن المفتاح يحمل النطاق الخاص بذلك المسار، وأن عنوان IP لخادمك مدرج في قائمة المسموح بها للمفتاح.404 داخل حسابك أن المعرّف غير موجود فيه. ولا يكشف أبدًا ما إذا كان المعرّف موجودًا في نشاط تجاري آخر.راسل support@huechat.ai مع مسار الطلب ورمز الحالة وX-HueChat-Delivery أو معرّف الطلب إن وُجد، والوقت بتوقيت UTC. لا ترسل المفتاح الكامل أبدًا؛ فالبادئة hc_ تكفي لتحديده.