الانتقال إلى المحتوى الرئيسي
واجهة برمجة التطبيقات للتحقق من رقم الهاتف توفر تدفقاً من خطوتين: إرسال رمز لمرة واحدة إلى رقم هاتف، ثم التحقق من الرمز. يكتشف النظام نوع مشغّل الاتصالات، والأرقام الافتراضية، والهواتف المؤقتة.

​
Endpoints

إرسال رمز الهاتف

POST /v3/phone/send/: أرسل رمز تحقق لمرة واحدة عبر SMS.

التحقق من رمز الهاتف

POST /v3/phone/check/: تحقق من الرمز واسترجع بيانات مخاطر الهاتف.

تقييم مخاطر الهاتف

POST /v3/phone/risk/: قيّم مخاطر مشغّل الاتصالات ونوع الخط ونقل الرقم والاحتيال دون إرسال OTP.

​
كيف يعمل

  1. استدعِ إرسال رمز الهاتف مع رقم الهاتف بصيغة E.164 (مثال: +14155552671)
  2. يتلقى المستخدم الرمز عبر SMS (صالح لمدة 5 دقائق)
  3. استدعِ التحقق من رمز الهاتف مع رقم الهاتف والرمز
  4. احصل على نتيجة التحقق مع إشارات المخاطر (نوع مشغّل الاتصالات، واكتشاف الرقم الافتراضي)

​
قنوات الإرسال

يدعم Didit قنوات متعددة حسب توفرها في الدولة:

​
إشارات المخاطر

للاطلاع على بنية الاستجابة الكاملة، راجع تقرير التحقق من رقم الهاتف.

​
انقطاعات المزوّد

إذا فشل مزوّد الهاتف الخارجي في الرد على طلب إرسال أو تحقق، تُرجع نقطتا الـendpoint استجابةً برمز 502 مع code: "phone_provider_unavailable" بدلاً من خطأ عام. يمكن إعادة المحاولة بأمان، ولا يُحتسب عليها أي رسوم، ولا تستهلك محاولة من الحد الساعي لكل رقم. استخدم الحقل code في التفرع المنطقي بدلاً من تحليل نص الرسالة detail، فنص الرسالة ليس عقداً ثابتاً.
آخر تعديل في ٧ نوفمبر ٢٠٢٦