الأخطاء
كل خطأ قد يرد به الـ API، وسببه، وما العمل.
ترد الأخطاء بحالة HTTP ومحتوى JSON فيه حقل واحد هو error:
{ "error": "Device is not connected" }قرّر ما تفعله بناءً على الحالة. وعندما يشترك خطآن في الحالة نفسها، مثل 402 و429، اقرأ نص error أيضًا.
| الحالة | error | السبب | ما العمل |
|---|---|---|---|
400 | invalid id | معرّف الجهاز في الرابط ليس عددًا صحيحًا موجبًا. | صحّح الرابط. |
400 | label is required، to and type are required، text is required for type=text، media_url is required for media types، url and secret are required | حقل مطلوب مفقود. | أرسل الحقل. |
400 | Unsupported type: … | قيمة type ليست text أو image أو document أو audio. | استخدم إحداها. |
400 | Invalid media URL: …، Failed to download media: …، Refusing to fetch media from a private/reserved address … | تعذّر تنزيل الملف من media_url. | استخدم رابط http/https عامًا يعمل. |
400 | Cap exceeds admin ceiling | أحد حدود الإرسال أعلى من الحد الأقصى المسموح. | استخدم حدًا أقل. |
401 | Missing or invalid Authorization header | لا توجد ترويسة Authorization: Bearer …. | أرسل مفتاح API. راجع المصادقة. |
401 | Invalid API key | المفتاح خاطئ أو أُلغي. | تحقق من المفتاح، أو أنشئ مفتاحًا جديدًا. |
402 | No active Subscription | لا يوجد اشتراك فعّال لمؤسستك. | جدّد. راجع الاشتراك. |
402 | Device Quota reached | لا تسمح باقتك بمزيد من الأجهزة. | رقِّ باقتك، أو احذف جهازًا لا تستخدمه. |
404 | Device not found | لا يوجد جهاز بهذا المعرّف في مؤسستك. | تحقق من المعرّف عبر GET /v1/devices. |
404 | No QR available. Device may already be connected. | لا يوجد رمز QR الآن. | تحقق من status، واطلبه مرة أخرى بعد ثوانٍ. |
409 | Device is not connected | الجهاز ليس connected. | اربطه من جديد. راجع الأجهزة. |
413 | Media exceeds … byte limit for type … | الملف أكبر من المسموح. | الصور حتى 5 ميغابايت، والمستندات والصوت حتى 16 ميغابايت. |
429 | Monthly Message Quota reached | انتهى حد الرسائل الشهري في باقتك. | انتظر الشهر القادم، أو رقِّ باقتك. |
429 | Rate limit exceeded (hourly cap: 60) أو (daily cap: 500) | بلغ الجهاز أحد حدود الإرسال. | أرسل لاحقًا، أو من جهاز آخر. |
500 | Internal Server Error | حدث خطأ من جهتنا. | حاول لاحقًا، وإن استمر فتواصل معنا. |
لا تُعد طلبات 400 و401 و402 و404 و409 دون تغيير شيء أولًا، فالطلب نفسه سيفشل مجددًا. أعِد 429 لاحقًا، و500 بعد انتظار قصير.