ReOTP.
واجهة البرمجة/1. تهيئة عملية التحقق
2 د دقائق قراءة

1. تهيئة عملية التحقق

بدء جلسة تحقق جديدة وإيقاظ سيرفر الاتصال.

نظام ReOTP يستخدم ميزة الإيقاظ عند الطلب للحفاظ على موارد السيرفر. هذا يعني أن اتصال الواتساب الخاص بك يكون نائماً، وعندما ترسل هذا الطلب، يستيقظ السيرفر ليفتح الاتصال ويكون جاهزاً لاستقبال رسالة العميل.

المعاملات المرسلة (Request Body):

  • apiKey (نص - إجباري): مفتاح الـ API الخاص بمشروعك.
  • phoneNumber (نص - إجباري): رقم هاتف المستخدم (مثال: +966500000000).
  • method (نص - اختياري): طريقة التحقق "WHATSAPP" أو "TELEGRAM" (الافتراضي: "WHATSAPP").
  • returnUrl (نص - اختياري): الرابط الذي سيتم إعادة توجيه العميل إليه بعد نجاح التحقق في تطبيق تيليجرام.

المعاملات المستلمة (Response Body):

  • requestId (نص): معرف العملية الفريد لمتابعة حالة التحقق.
  • waLink (نص): رابط الواتساب (يُرجع فقط إذا كانت الطريقة WHATSAPP).
  • tgLink (نص): رابط تيليجرام (يُرجع فقط إذا كانت الطريقة TELEGRAM).
  • expectedText (نص): نص الرسالة التلقائية التي يجب إرسالها.
  • expiresIn (نص): وقت انتهاء صلاحية الطلب (دقيقتين).

ملاحظات هامة:

  • مدة الصلاحية: أمام العميل دقيقتين فقط (02:00) لفتح الرابط وإرسال الرسالة التلقائية من هاتفه قبل أن تنتهي صلاحية الجلسة ويعود السيرفر للنوم.
  • واجهة المستخدم: نوصي بشدة بعرض عداد تنازلي (Countdown) للعميل في واجهتك لحثه على الإسراع بإرسال الرسالة.

أرسل طلب POST إلى الرابط الموضح في لوحة الكود الجانبية لبدء العملية.

كود التوثيق البرمجي (SDKs)
curl -X POST https://[your-domain.com]/api/verify/init \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "method": "WHATSAPP"
  }'
محاكاة حية وتفاعلية
منصة تفاعلية لاختبار الـ API

أدخل رقم الهاتف لتهيئة الجلسة واختبار استجابة السيرفر لحظياً:

اختبار الـ API التفاعلي المباشر (Interactive API Playground)

قم بتجربة إرسال طلبات التحقق مباشرة وتوليد أكواد الـ Integration باللغة البرمجية التي تفضلها.

curl -X POST https://reotp.com/api/verify/init \
  -H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "201000000000",
    "method": "WHATSAPP"
  }'
المقال السابقحدود الاستخدام وحظر الإزعاج
المقال التالي2. فحص حالة التحقق