إعادة إرسال رمز التحقق
يعيد إرسال رمز جديد لنفس المحاولة وفق إعدادات التهدئة والحد الأقصى. أرسل verificationId أو to.
متى تستخدمه. عندما يقول المستخدم إنه لم يستلم الرمز بعد انتهاء التهدئة.
مثال الطلب
مثال صحيح: إعادة إرسال بالمعرّف
curl --location 'https://raselsms.com/api/v2/verification/resend' \--header 'X-API-Key: YOUR_API_KEY' \--header 'Content-Type: application/json' \--data '{"verificationId":"6800abc123def4567890fedc","channel":"int_sms"}'مثال خاطئ: خطأ: إعادة إرسال أثناء التهدئة
curl --location 'https://raselsms.com/api/v2/verification/resend' \--header 'X-API-Key: YOUR_API_KEY' \--header 'Content-Type: application/json' \--data '{"verificationId":"6800abc123def4567890fedc"}'يجب انتظار resendAvailableAt.
مثال الاستجابة
200 — إعادة إرسال بالمعرّف
{ "verificationId": "6800abc123def4567890fedc", "status": "sent", "channel": "int_sms", "expiresAt": "2026-09-05T10:10:00.000Z", "resendAvailableAt": "2026-09-05T10:01:00.000Z", "resendCount": 1}400 — خطأ: إعادة إرسال أثناء التهدئة
{ "success": false, "code": "VERIFICATION_RESEND_COOLDOWN", "error": "Resend is not available yet", "verificationId": "6800abc123def4567890fedc", "resendAvailableAt": "2026-09-05T10:01:00.000Z", "resendCount": 0}يجب انتظار resendAvailableAt.
401 — مفتاح غير صالح.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "UNAUTHORIZED", "error": "Missing or invalid API key"}طلب HTTP
POST /api/v2/verification/resend
ترويسات الطلب
| الترويسة | النوع | الوصف |
|---|---|---|
| X-API-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
جسم الطلب
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| verificationId | string | المعرّف الراجع من خطوة إرسال التحقق. فضّله في إعادة الإرسال والتحقق. | |
| to | string | المستلم: رقم دولي E.164، أو بريد عندما تكون القناة email، أو معرّف مجموعة واتساب، أو معرّف محادثة تلغرام، أو مصفوفة نصوص حتى 100 مستلم للدفعة الرسمية. | |
| channel | enum | قناة التسليم. في الإرسال الموحّد فضّل auto أو local_sms أو int_sms أو official_whatsapp أو جلسات واتساب ويب أو telegram_bot أو email_user. في التحقق احذف الحقل للاختيار التلقائي، ولا ترسل sms أو whatsapp أو auto وحدها. | |
| senderId | string | معرّف مرسل SMS معتمد. إن حُذف يُستخدم الافتراضي ثم مرسل المنصة. | |
| officialSenderId | string | معرّف مرسل واتساب الرسمي من /api/v2/official-senders. مرادف sender.officialId. استخدم platform لرقم ميتا الافتراضي عند قائمة القوالب. | |
| sender | object | تجاوز اختياري للمرسل. إن حُذف يستخدم راسل المرسل المعتمد الافتراضي ثم مرسل المنصة. | |
| sender.id | string | معرّف مرسل SMS المعتمد. احذفه لاستخدام المرسل الافتراضي. | |
| sender.officialId | string | معرّف مرسل واتساب الرسمي. نفس officialSenderId. |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| verificationId | string | المعرّف الراجع من خطوة إرسال التحقق. فضّله في إعادة الإرسال والتحقق. | |
| status | enum | حالة التسليم أو السجل. في الإرسال: sent أو queued أو scheduled. في الموارد الأخرى هي فلتر الحالة أو قيمتها. | |
| channel | string | قناة التسليم. في الإرسال الموحّد فضّل auto أو local_sms أو int_sms أو official_whatsapp أو جلسات واتساب ويب أو telegram_bot أو email_user. في التحقق احذف الحقل للاختيار التلقائي، ولا ترسل sms أو whatsapp أو auto وحدها. | |
| channels | string-list | أسماء القنوات العامة عندما ينجح التوزيع على أكثر من قناة متوافقة. | |
| deliveries | json | تتبع لكل قناة عند تفعيل التوزيع. | |
| expiresAt | string | وقت انتهاء رمز التحقق الحالي. | |
| resendAvailableAt | string | أقرب وقت يُسمح فيه بإعادة الإرسال. | |
| resendCount | number | عدد مرات إعادة إرسال الرمز. | |
| trial | object | يظهر لحسابات الخطة التجريبية. القالب يبقي {code} ولا يتضمن رمز التحقق نفسه. sent_as_is يعني أن النص المعتمد أُرسل كما هو، substituted يعني أن طلب التحقق استُبدل بهذا النص، وrejected يعني أن المحتوى المخصص لم يُرسل. | |
| trial.active | enum | الحساب على الخطة التجريبية. * | |
| trial.action | enum | ماذا فعل النظام بالنص: أرسله كما هو، أو استبدله بالنص المعتمد، أو رفض المحتوى المخصص. * | |
| trial.template | string | مرجع القالب (id أو key) واللغة والمتغيرات وهيدر اختياري لهذا الإرسال. * | |
| trial.ignored | string-list | حقول أرسلها العميل ولم تُستخدم في الرسالة التي خرجت. | |
| trial.message | string | رسالة نتيجة مقروءة بعد الإنشاء أو الرفع. * | |
| trial.upgradeHref | string | مسار ترقية الخطة داخل لوحة التحكم. * | |
| trial.example | object | مثال طلب ينجح أثناء التجربة. يظهر عند الرفض فقط. | |
| trial.example.method | enum | طريقة الطلب في المثال. | |
| trial.example.path | string | مسار الطلب الذي يرسل رمز التحقق بدون نص مخصص. | |
| trial.example.body | object | متن قالب واتساب مع عناصر نائبة مرقمة. اربطه بـ bodyParameters عند الإنشاء وvariablesIndexed عند الإرسال. | |
| trial.example.body.to | string | المستلم: رقم دولي E.164، أو بريد عندما تكون القناة email، أو معرّف مجموعة واتساب، أو معرّف محادثة تلغرام، أو مصفوفة نصوص حتى 100 مستلم للدفعة الرسمية. | |
| trial.example.body.channel | string | قناة التسليم. في الإرسال الموحّد فضّل auto أو local_sms أو int_sms أو official_whatsapp أو جلسات واتساب ويب أو telegram_bot أو email_user. في التحقق احذف الحقل للاختيار التلقائي، ولا ترسل sms أو whatsapp أو auto وحدها. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 400 | طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة. |
| 404 | المورد غير موجود لمالك مفتاح API. |
| 409 | تعارض، مثل إعادة استخدام مفتاح Idempotency بجسم مختلف، أو جلسة غير جاهزة. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
| 401 | مفتاح API مفقود أو غير صالح. |
جرّب الطلب
قد يخصم هذا الطلب من رصيد المحفظة أو حصة الباقة.
لست مسجلاً، أو رفض الخادم هذه الجلسة. القوائم تبقى فارغة إلى أن تسجّل الدخول أو تكتب مفتاحاً صالحاً، ولن يظهر حساب شخص آخر.
المتغيرات
قناة التسليم. في الإرسال الموحّد فضّل auto أو local_sms أو int_sms أو official_whatsapp أو جلسات واتساب ويب أو telegram_bot أو email_user. في التحقق احذف الحقل للاختيار التلقائي، ولا ترسل sms أو whatsapp أو auto وحدها.
المستلم: رقم دولي E.164، أو بريد عندما تكون القناة email، أو معرّف مجموعة واتساب، أو معرّف محادثة تلغرام، أو مصفوفة نصوص حتى 100 مستلم للدفعة الرسمية.
معرّف مرسل واتساب الرسمي من /api/v2/official-senders. مرادف sender.officialId. استخدم platform لرقم ميتا الافتراضي عند قائمة القوالب.
المعرّف الراجع من خطوة إرسال التحقق. فضّله في إعادة الإرسال والتحقق.
معرّف مرسل SMS معتمد. إن حُذف يُستخدم الافتراضي ثم مرسل المنصة.
الطلب
{}الاستجابة
نفّذ طلباً لعرض الاستجابة.