التحقق من كود واتساب الذي كتبه المستخدم عبر الواجهة البرمجية
مرجع عنوان التحقق من الكود في واجهة عربي بوت: الحقول، الرد، الكود الخاطئ وعدد المحاولات، الكود المنتهي، وحالات الرفض.
في هذه الصفحة 8
الإجابة المختصرة
بطلب POST إلى العنوان verify فيه معرّف الطلب والكود الذي كتبه المستخدم. إن طابق الكود عاد الرد بنجاح ومعه رقم الهاتف ووقت التحقق. الكود يُقبل مرة واحدة، والكود الخاطئ يعود معه عدد المحاولات الباقية، وبعد استنفادها يطلب المستخدم كودًا جديدًا.
يُسأل عنها أيضًا: «اتحقق من كود الواتساب في الكود ازاي» · «التحقق من رمز otp واتساب»
العنوان والتوثيق
POST https://app.arabybot.com/wa_otp_api/verify
أرسل المفتاح العام لتطبيق كود التحقق في الترويسة X-Public-Key: ab_otp_…. تنشئ التطبيق من قسم كود التحقق في اللوحة، فيعطيك المفتاح العام وسرًّا يُعرض مرة واحدة. وإن فعّلت توقيع الطلبات في التطبيق أضفت الترويسة X-Signature: sha256=…، وقيمتها HMAC-SHA256 لجسم الطلب الخام بسر التطبيق.
الحقول
request_id(مطلوب) معرّف الطلب الذي عاد عند إرسال الكود.code(مطلوب) الكود الذي كتبه المستخدم.
مثال طلب
cURL
curl -X POST https://app.arabybot.com/wa_otp_api/verify \
-H "X-Public-Key: ab_otp_YOUR_PUBLIC_KEY" \
-H "Content-Type: application/json" \
-d '{ "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60", "code": "482913" }' PHP
$ch = curl_init('https://app.arabybot.com/wa_otp_api/verify');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Public-Key: ab_otp_YOUR_PUBLIC_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'request_id' => '3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60',
'code' => '482913',
]),
]);
$answer = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch); Python
import requests
r = requests.post(
'https://app.arabybot.com/wa_otp_api/verify',
headers={
"X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY",
},
json={
"request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
"code": "482913",
},
timeout=30,
)
print(r.status_code, r.json()) Node.js
// Node.js 18+
const r = await fetch('https://app.arabybot.com/wa_otp_api/verify', {
method: 'POST',
headers: {"X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY", "Content-Type": "application/json"},
body: JSON.stringify({
"request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
"code": "482913"
}),
});
console.log(r.status, await r.json());
الرد
200
{ "success": true, "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
"phone": "966501234567", "verified_at": "2026-11-16 18:05:02" } - الكود يُقبل مرة واحدة؛ طلب التحقق نفسه مرة ثانية يعود بالحالة 410.
ما قسناه على هذه الواجهة
نصف المستخدمين كتبوا الكود خلال 13 إلى 25 ثانية، وتسعة من كل عشرة خلال 46 ثانية؛ فصلاحية من دقائق قليلة تكفي. ومن كل مئة كود أُرسل أُكِّد نحو 75. وحدود هذا القياس أن تطبيقًا واحدًا يحمل 91% من الإرسال؛ فهي أرقام هذه التطبيقات لا متوسط عام.
حالات الرفض
كل رفض يعود JSON فيه "success": false وerror_code وmessage، ومعه retry_after بالثواني حين يكون السبب حدًّا زمنيًّا:
- 401
invalid_code: الكود خاطئ؛ عدد المحاولات الباقية فيattempts_remaining. - 401
missing_key / invalid_key: المفتاح العام غائب أو خاطئ. - 401
missing_signature / bad_signature: التطبيق يطلب توقيع الطلبات والتوقيع غائب أو لا يطابق. - 404
not_found: لا طلب بهذا المعرّف. - 410
expired / already_resolved: انتهت صلاحية الكود، أو حُسم الطلب من قبل. - 422
missing_fields: معرّف الطلب أو الكود غائب. - 429
too_many_attempts: استُنفدت المحاولات؛ اطلب كودًا جديدًا.
الحدود
كل كود رسالة واتساب مدفوعة بسعر ميتا لقوالب التحقق في بلد المستلم. وللحماية حدود على عدد الطلبات للرقم الواحد وللتطبيق في الدقيقة وفي اليوم؛ تجاوزها يعيد الحالة 429 ومعها retry_after بالثواني.
دليل واجهة كود التحقق · كل الواجهات للمطورين
الأسئلة الشائعة
كم مرة يستطيع المستخدم أن يخطئ في الكود؟
مع كل كود خاطئ يعود عدد المحاولات الباقية في attempts_remaining. حين تُستنفد يعود الطلب بالكود too_many_attempts، فتطلب كودًا جديدًا.
من أين أستدعي التحقق: من المتصفح أم من الخادم؟
من خادمك. نتيجة التحقق هي ما يفتح الحساب أو يؤكد الطلب، فلا تتركها لصفحة يتحكم فيها الزائر، ولا تضع سر التطبيق في متصفح.
اقرأ بعدها
جرّب الوكيل قبل أن تدفع شيئًا
الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.