الأعطال الشائعة

قرّر ما يجب فعله بناءً على حالة HTTP وقيمة code في الاستجابة. لا تُبنِ منطق التفرّع على نص message.

العرَض	الإجراء
AUTH_INVALID	راجع clientId وclientSecret
APP_DISABLED	تأكّد أن API Client والتطبيق نشطان
AUTH_SCOPE_DENIED	أضِف الصلاحية المحدّدة في data.requiredScope، ثم احصل على access token جديد
AUTH_EXPIRED	احصل على access token جديد وأعد محاولة القراءة الفاشلة مرة واحدة
data.devices فارغة	تأكّد أن الجهاز ينتمي إلى الحساب وأن API Client يستطيع الوصول إليه
RATE_LIMITED	انتظر مدة Retry-After؛ لا تعد المحاولة فورًا
DEVICE_OFFLINE	انتظر إعادة الاتصال أو استخدم آخر حالة متزامنة حيث تتيحها نقطة النهاية
أمر بلا نتيجة نهائية	استعلم عنه بمعرّف الأمر؛ لا تكرر عملية ذات آثار جانبية دون تروٍّ

سجّل requestId عند التواصل مع الدعم.

مزيد من حل المشكلات

• تنسيق الاستجابة (بالإنجليزية)
• أخطاء المصادقة والتفويض (بالإنجليزية)
• أخطاء الموارد والأوامر (بالإنجليزية)
• الأسئلة الشائعة
• تواصل مع الدعم