> ## Documentation Index
> Fetch the complete documentation index at: https://developers.huechat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# موثوقية API

> المعالجة والمراقبة وإعادة المحاولة وأنماط التكامل الآمنة.

واجهة HueChat العامة هي REST متزامنة تنفذها خدمة HueChat المكتوبة بلغة Go.
حالة HTTP والجسم هما نتيجة الطلب نفسه. لا تظهر طلبات REST العامة كمهام في
طوابير الخلفية؛ فالمهام الخلفية نظام منفصل.

## ما الذي يقيسه HueChat؟

يسجل HueChat للاستخدام الموثق ملخصات ساعية محدودة البيانات حسب الحساب ومفتاح
API وطريقة HTTP وقالب المسار والحالة. تشمل القياسات عدد الطلبات والأخطاء وحالات
`429` وزمن الاستجابة وحجمها. وتحتفظ الأخطاء الحديثة بمعرف الطلب ورمز الخطأ
للتشخيص.

لا تحفظ هذه القياسات ترويسة `Authorization` أو المفتاح الصريح أو جسم الطلب أو
الاستجابة أو نص الاستعلام أو قيم المسار مثل معرفات جهات الاتصال والمواعيد.
يستطيع مدير الحساب مراجعة استخدام كل مفتاح من **الإعدادات ← المطوّرون ← مفاتيح
API**.

## بناء تكامل مستقر

1. أنشئ مفتاحًا مستقلًا لكل شريك أو خدمة وامنحه النطاقات اللازمة فقط.
2. أضف قائمة IP مسموحة عندما تكون عناوين الخادم الصادرة ثابتة.
3. اضبط معدل المفتاح وفق الحمل المتوقع وضمن حد الحساب الفعلي.
4. استخدم `external_id` لمزامنة المواعيد، واحتفظ بالحمولة نفسها عند إعادة طلب
   إنشاء انتهت مهلته.
5. فضّل Webhooks على الاستعلام المتكرر واستخدم صفحات قوائم محدودة للمطابقة.
6. سجّل معرف طلب HueChat وحالة HTTP ورمز `code`، ولا تسجل مفتاح API.
7. راقب أخطاء كل مفتاح وحالات الحد والزمن، ودوّر المفتاح قبل انتهائه وألغِ غير
   المستخدم.

## قرارات إعادة المحاولة

| النتيجة                                   | الإجراء                                                                           |
| ----------------------------------------- | --------------------------------------------------------------------------------- |
| `400` أو `403` أو `404` أو `409` أو `422` | صحح الطلب أو الصلاحية أو الحالة أو الإصدار؛ لا تكرر الطلب نفسه                    |
| `402 api_not_available_on_plan`           | اطلب من مالك الحساب تفعيل API أو تغيير الخطة                                      |
| `429 rate_limit_exceeded`                 | انتظر `Retry-After` ثم استخدم تراجعًا أسّيًا مع عشوائية                           |
| `429 monthly_quota_exceeded`              | انتظر الشهر التالي بتوقيت UTC أو راجع السعة مع مالك الحساب                        |
| `503 api_policy_unavailable`              | أعد محاولة القراءة بتراجع؛ وفي الكتابة حافظ على هوية عدم التكرار وتحقق من النتيجة |
| خطأ `5xx` آخر أو انتهاء الشبكة            | تراجع وتحقق من نتيجة الكتابة قبل إعادتها                                          |

لعمليات المواعيد راجع [المواعيد والجدولة](/ar/appointments) لمعرفة الهوية
الخارجية وإصدار `version` والتوفر وقواعد دورة الحياة. وراجع [حدود المعدل
والحصص](/ar/rate-limits) لكل الترويسات والاستجابات.