GET/api/v2/messages/bulk/{jobId}/errors
أخطاء مهمة الإرسال الجماعي
صفحة من الصفوف التي تحمل رمز خطأ، سواء من الفحص أو من الإرسال. الصفحة 50 صفاً. لا يتضمن الرد نص الرسالة.
متى تستخدمه. قراءة أسباب الرفض أو فشل الصفوف دون تنزيل النص.
مثال الطلب
مثال صحيح: صحيح: خطأ فحص
curl --location 'https://raselsms.com/api/v2/messages/bulk/64b0c0ff0000000000000001/errors?cursor=0' \--header 'X-API-Key: YOUR_API_KEY'مثال الاستجابة
200 — صحيح: خطأ فحص
{ "success": true, "errors": [ { "index": 1, "code": "SENDER_NOT_FOUND", "message": "Sender was not found" } ], "nextCursor": null}404 — لا توجد مهمة بهذا المعرّف لهذا الحساب. الرمز JOB_NOT_FOUND.
{ "success": false, "code": "JOB_NOT_FOUND", "error": "Job was not found"}401 — مفتاح API مفقود أو غير صالح.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "UNAUTHORIZED", "error": "Missing or invalid API key"}403 — الهاتف غير موثّق أو تنقص صلاحية messages:read. الرمز FORBIDDEN.
{ "success": false, "code": "FORBIDDEN", "error": "Phone not verified or missing permission"}429 — تم تجاوز حد الطلبات. انتظر Retry-After إن وُجد.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "RATE_LIMITED", "error": "Rate limit exceeded", "retryAfterSeconds": 30}طلب HTTP
GET /api/v2/messages/bulk/{jobId}/errors
ترويسات الطلب
| الترويسة | النوع | الوصف |
|---|---|---|
| X-API-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
معاملات المسار
| الحقل | النوع | الوصف |
|---|---|---|
| jobId | string | معرّف المهمة من رد الإنشاء. المهمة ظاهرة لصاحب المفتاح فقط. * |
معاملات الاستعلام
| الحقل | النوع | الوصف |
|---|---|---|
| cursor | integer | مؤشر ترقيم غير شفاف من الاستجابة السابقة. |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| success | enum | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. * | |
| errors | json | صفحة الصفوف التي تحمل رمز خطأ من الفحص أو من الإرسال. الصفوف المتوقفة بلا رمز لا تظهر هنا. * | |
| nextCursor | integer | مؤشر الصفحة التالية. null يعني أن هذه آخر صفحة. أعده كما هو في الطلب التالي. * |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 404 | المورد غير موجود لمالك مفتاح API. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
حالات يجب أن تعرفها
- رموز الفحص: SCHEDULE_NOT_ALLOWED وTO_REQUIRED وCONTENT_REQUIRED وMARKETING_NOT_ALLOWED وCONTENT_BLOCKED وSENDER_NOT_FOUND وTEMPLATE_REQUIRED وTEMPLATE_NOT_FOUND وTEMPLATE_UNAVAILABLE. صيغة المستلم تستخدم رموز الإرسال المفرد.
- فشل الإرسال يستخدم رمز الإرسال المفرد، أو SEND_FAILED إن غاب الرمز. SUBSCRIPTION_INACTIVE يعني أن الاشتراك توقف وفشلت الصفوف المتبقية وأُغلقت المهمة completed.
- المستلم المحظور أو المنسحب يفشل صفه وقت الإرسال وتكمل المهمة. تعذّر مرسل صف واحد يفشل ذلك الصف فقط.
جرّب الطلب
المتغيرات
معرّف المهمة من رد الإنشاء. المهمة ظاهرة لصاحب المفتاح فقط.
مؤشر ترقيم غير شفاف من الاستجابة السابقة.
الطلب
GET /api/v2/messages/bulk//errorsالاستجابة
نفّذ طلباً لعرض الاستجابة.