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

Endpoints

إرسال رمز البريد الإلكتروني

POST /v3/email/send/ — إرسال رمز تحقق لمرة واحدة إلى عنوان بريد إلكتروني.

التحقق من رمز البريد الإلكتروني

POST /v3/email/check/ — التحقق من الرمز واسترجاع بيانات مخاطر البريد الإلكتروني.

تقييم مخاطر البريد الإلكتروني

POST /v3/email/risk/ — تقييم مخاطر قابلية التسليم والخروقات والبريد الإلكتروني المؤقت دون إرسال رمز.

كيف تعمل

  1. استدعِ إرسال رمز البريد الإلكتروني مع عنوان البريد الإلكتروني المستهدف
  2. يتلقى المستخدم رمزاً مكوناً من 6 أرقام (صالحاً لمدة 5 دقائق)
  3. استدعِ التحقق من رمز البريد الإلكتروني مع البريد الإلكتروني والرمز
  4. تستلم نتيجة التحقق إضافةً إلى إشارات المخاطر (التعرض لخروقات البيانات، ومزوّد البريد الإلكتروني القابل للتخلص منه، وقابلية التسليم)
تُرسل رسائل OTP المستقلة افتراضياً بعلامة Didit التجارية. لاستخدام مرسل العلامة البيضاء وعلامتك التجارية المُهيأة في تطبيقك لجلسة تحقق بالبريد الإلكتروني محددة، مرّر options.use_white_label_customization: true إلى POST /v3/email/send/. القيمة الافتراضية هي false.

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

تتضمن استجابة التحقق ما يلي: للاطلاع على البنية الكاملة للاستجابة، راجع تقرير التحقق من البريد الإلكتروني.
آخر تعديل في ٧ نوفمبر ٢٠٢٦