الأخطاء ورموز HTTP

غلاف الخطأ

{
  "error": {
    "code": "validation",
    "message": "Missing required field: phone"
  }
}

رموز حالة HTTP

الحالة	المعنى
200	OK
201	تم الإنشاء
202	مقبول (في قائمة الانتظار / غير متزامن)
400	خطأ في التحقق / طلب غير صحيح
401	مفتاح API مفقود أو غير صالح
403	النطاق / عنوان IP / الشريك غير مسموح
404	المورد غير موجود
422	تحقق دلالي (مثل حقول النموذج)
429	تجاوز معدل الطلبات
500	خطأ في الخادم

القيم الشائعة لـerror.code

الرمز	الوصف
unauthorized	مفتاح API أو الرمز المميز غير صالح
forbidden	النطاق مفقود أو عنوان IP مرفوض أو الشريك غير صحيح
validation	جسم الطلب غير صالح
not_found	id / phone / template غير معروف
blocked	حساب ألغى الاشتراك
bot_error	خطأ في محرك التدفق / الروبوت

حالات التسليم (الرسائل)

الحالة	المعنى
queued	مقبول، ولم يكتمل تسليمه بعد
sending	جارٍ الإرسال
delivered	سُلّم إلى القناة / in-app
read	قرأه المستخدم (عند تفعيل التتبع)
failed	فشلت جميع القنوات
expired	انتهت صلاحيته

تعارضات التكرار الآمن

تؤدي إعادة استخدام idempotency_key إلى إرجاع الرسالة الأصلية مع 200 بدلًا من إنشاء نسخة مكررة.