ابدأ الآن
التكامل / SDKs
التحقق من المستخدمين
التحقق من الشركات
مراقبة المعاملات
سجل التغييراتcurl -X POST https://verification.didit.me/v3/email/check/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"email": "alice@example.com",
"code": "123456",
"disposable_email_action": "DECLINE"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.email.check_code(
email="alice@example.com",
code="123456",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.email.checkCode({
email: "alice@example.com",
code: "123456",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Email.CheckCode(ctx, didit.EmailCheckCodeParams{
Email: "alice@example.com",
Code: "123456",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.EmailCheckCodeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.email().checkCode(EmailCheckCodeParams.builder()
.email("alice@example.com")
.code("123456")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->email->checkCode([
'email' => 'alice@example.com',
'code' => '123456',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.email.check_code(
email: "alice@example.com",
code: "123456"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Email.CheckCodeAsync(new EmailCheckCodeParams
{
Email = "alice@example.com",
Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "e39cb057-92fc-4b59-b84e-02fec29a0f24",
"status": "Approved",
"message": "The verification code is correct.",
"email": {
"status": "Approved",
"email": "alice@example.com",
"is_breached": false,
"breaches": [],
"is_disposable": false,
"is_undeliverable": false,
"verification_attempts": 1,
"verified_at": "2026-06-12T01:24:47.311323Z",
"warnings": [],
"lifecycle": [
{
"type": "EMAIL_VERIFICATION_MESSAGE_SENT",
"timestamp": "2026-06-12T01:23:39.580554+00:00",
"details": {
"status": "Success",
"reason": null
},
"fee": 0.02
},
{
"type": "VALID_CODE_ENTERED",
"timestamp": "2026-06-12T01:24:47.311201+00:00",
"details": {
"code_tried": "123456",
"status": "Approved"
},
"fee": 0
},
{
"type": "EMAIL_VERIFICATION_APPROVED",
"timestamp": "2026-06-12T01:24:47.384292+00:00",
"details": null,
"fee": 0
}
],
"matches": []
},
"vendor_data": "user-1234",
"metadata": null,
"created_at": "2026-06-12T01:24:47.401719+00:00"
}واجهة API للتحقق من رمز البريد الإلكتروني
التحقق من رمز البريد لمرة واحدة عبر POST /v3/email/check/ مع إشارات الاختراق والعناوين المؤقتة من Didit. دفع حسب الاستخدام بلا عقود.
curl -X POST https://verification.didit.me/v3/email/check/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"email": "alice@example.com",
"code": "123456",
"disposable_email_action": "DECLINE"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.email.check_code(
email="alice@example.com",
code="123456",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.email.checkCode({
email: "alice@example.com",
code: "123456",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Email.CheckCode(ctx, didit.EmailCheckCodeParams{
Email: "alice@example.com",
Code: "123456",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.EmailCheckCodeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.email().checkCode(EmailCheckCodeParams.builder()
.email("alice@example.com")
.code("123456")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->email->checkCode([
'email' => 'alice@example.com',
'code' => '123456',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.email.check_code(
email: "alice@example.com",
code: "123456"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Email.CheckCodeAsync(new EmailCheckCodeParams
{
Email = "alice@example.com",
Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "e39cb057-92fc-4b59-b84e-02fec29a0f24",
"status": "Approved",
"message": "The verification code is correct.",
"email": {
"status": "Approved",
"email": "alice@example.com",
"is_breached": false,
"breaches": [],
"is_disposable": false,
"is_undeliverable": false,
"verification_attempts": 1,
"verified_at": "2026-06-12T01:24:47.311323Z",
"warnings": [],
"lifecycle": [
{
"type": "EMAIL_VERIFICATION_MESSAGE_SENT",
"timestamp": "2026-06-12T01:23:39.580554+00:00",
"details": {
"status": "Success",
"reason": null
},
"fee": 0.02
},
{
"type": "VALID_CODE_ENTERED",
"timestamp": "2026-06-12T01:24:47.311201+00:00",
"details": {
"code_tried": "123456",
"status": "Approved"
},
"fee": 0
},
{
"type": "EMAIL_VERIFICATION_APPROVED",
"timestamp": "2026-06-12T01:24:47.384292+00:00",
"details": null,
"fee": 0
}
],
"matches": []
},
"vendor_data": "user-1234",
"metadata": null,
"created_at": "2026-06-12T01:24:47.401719+00:00"
}الإضافة الاستخباراتية
اضبطenable_enrichment على true لتشغيل استخبارات البريد الإلكتروني على العنوان أيضًا، فتحصل على درجة المخاطر وسجل تسريبات البيانات المرتبطة به.
تُحتسب الإضافة بسعر $0.05 لكل طلب وفق السعر المعلن، وتُضاف إلى سعر الفحص نفسه.
يُعيد الطلب الاستجابة 403 عندما لا يغطي رصيدك تكلفتها.
تحدد ثلاثة حقول ما تفعله الإشارات. كل حقل منها إما NO_ACTION (وهي القيمة الافتراضية) أو DECLINE، ولا يسري أي منها إلا عندما تكون قيمة enable_enrichment هي true.
| الحقل | يُرفض عندما |
|---|---|
email_intelligence_score_action | تتجاوز درجة المخاطر الحد المحدد. |
recent_email_breach_action | يظهر العنوان في تسريب بيانات معروف وحديث. |
frequent_email_breach_action | يظهر العنوان في عدة تسريبات بيانات معروفة. |
NO_ACTION، تُعاد الإشارة في email.email_intelligence مع ذلك، لتتمكن من تطبيق قاعدتك الخاصة.التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
الجسم
عنوان البريد الإلكتروني نفسه المستخدم في استدعاء POST /v3/email/send/ المطابق. هذا ما يربط التحقق بعملية الإرسال.
"alice@example.com"
رمز OTP الذي استلمه المستخدم النهائي: من 4 إلى 8 أرقام، أو من 4 إلى 8 أحرف/أرقام عند استخدام alphanumeric_code: true في وقت الإرسال. المقارنة لا تتأثر بحالة الأحرف.
10"123456"
الإجراء المتخذ عند استخدام نفس العنوان مسبقاً وقبوله من قبل مستخدم مختلف (يتم احتساب عمليات التحقق المقبولة سابقاً فقط) (بيانات vendor_data مختلفة) لتطبيقك. يؤدي خيار DECLINE إلى تحويل status النهائي إلى Declined؛ ويسجل خيار NO_ACTION المخاطر في email.warnings ويملأ email.matches.
NO_ACTION, DECLINE الإجراء المتبع عندما يظهر العنوان في تسريبات بيانات معروفة (email.is_breached). يحول DECLINE القيمة النهائية لـ status إلى Declined؛ ويسجل NO_ACTION الخطر في email.warnings.
NO_ACTION, DECLINE الإجراء المتخذ عندما ينتمي النطاق إلى موفر بريد إلكتروني مؤقت أو يمكن التخلص منه (email.is_disposable). يؤدي خيار DECLINE إلى تحويل status النهائي إلى Declined؛ ويسجل خيار NO_ACTION المخاطر في email.warnings.
NO_ACTION, DECLINE عندما تكون true، يتم أيضاً تشغيل استخبارات البريد الإلكتروني على العنوان: درجة المخاطر وسجل الاختراقات الخاص به. تتم الفوترة كوحدة email_intelligence_api واحدة لكل طلب ($0.05 بسعر القائمة) بالإضافة إلى سعر endpoint هذا نفسه. يُرجع الطلب 403 عندما لا يكفي رصيدك لتغطيته.
false
الإجراء عند تجاوز درجة مخاطر معلومات البريد الإلكتروني للحد المعين. القيمة DECLINE تحول الـ status النهائي إلى Declined؛ والقيمة NO_ACTION تسجل الإشارة دون رفض. يسري مفعوله فقط عندما يكون enable_enrichment مضبوطاً على true.
NO_ACTION, DECLINE الإجراء المتخذ عندما يظهر العنوان في تسريب بيانات معروف حديث. يغير DECLINE الـ status النهائي إلى Declined؛ ويسجل NO_ACTION الإشارة دون رفض. يسري مفعوله فقط عندما يكون enable_enrichment مضبوطاً على true.
NO_ACTION, DECLINE الإجراء المتخذ عندما يظهر العنوان في العديد من تسريبات البيانات المعروفة. يغير DECLINE الـ status النهائي إلى Declined؛ ويسجل NO_ACTION الإشارة دون رفض. يسري مفعوله فقط عندما يكون enable_enrichment مضبوطاً على true.
NO_ACTION, DECLINE عند التعيين على true، يتم أيضاً البحث عن الأثر الرقمي الاجتماعي للعنوان - منصات البريد الإلكتروني والمنصات الاجتماعية والمهنية والتجارة الإلكترونية والترفيه المسجل عليها. يُفوتر كوحدة email_social واحدة لكل طلب بالإضافة إلى سعر هذا الـ endpoint نفسه.
true
الإجراء عندما يجد فحص الأثر الاجتماعي أن العنوان غير مسجل على أي من المنصات التي يغطيها. يُقبل فقط NO_ACTION وDECLINE في هذا الـ endpoint؛ يتوفر REVIEW في مفتاح تهيئة سير العمل الذي يحمل نفس الاسم.
NO_ACTION, DECLINE الاستجابة
اكتمل التحقق — تُرجع الرموز الخاطئة وعمليات التحقق المفقودة أيضاً الرمز 200؛ تحقّق من status، وليس رمز HTTP. يتم ملء email فقط في النتائج النهائية (Approved/Declined)، ويكون null عند Failed، وغير موجود عند Expired or Not Found.
عند Approved/Declined: معرّف الجلسة لعملية التحقق المتطابقة — مطابق لـ request_id المُرجع بواسطة POST /v3/email/send/. عند Failed وExpired or Not Found: معرّف UUID عشوائي لمرة واحدة لا يمكن البحث عنه لاحقاً.
Approved — رمز صحيح، دون وجود مخاطر تؤدي إلى الرفض. Declined — نهائية: تطابقت مخاطر تؤدي إلى الرفض أو استُنفد الحد المسموح به من المحاولات (3). Failed — رمز خاطئ، مع بقاء محاولات متبقية. Expired or Not Found — لا توجد عملية تحقق معلقة لهذا العنوان خلال آخر 5 دقائق.
Approved, Declined, Failed, Expired or Not Found تفسير سهل القراءة للنتيجة، بما في ذلك عدد المحاولات المتبقية بعد إدخال رمز خاطئ.
تقرير البريد الإلكتروني الكامل. موجود (غير null) فقط في النتائج النهائية (Approved/Declined)؛ ويكون null في حالة Failed وغير موجود في حالة Expired or Not Found.
Show child attributes
Show child attributes
vendor_data لجلسة التحقق المطابقة. وتكون null عند Expired or Not Found.
metadata لجلسة التحقق المتطابقة. null عند Expired or Not Found.
الطابع الزمني لاستجابة هذا الفحص.