Skip to main content
واجهة 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. راقب أخطاء كل مفتاح وحالات الحد والزمن، ودوّر المفتاح قبل انتهائه وألغِ غير المستخدم.

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

لعمليات المواعيد راجع المواعيد والجدولة لمعرفة الهوية الخارجية وإصدار version والتوفر وقواعد دورة الحياة. وراجع حدود المعدل والحصص لكل الترويسات والاستجابات.