واجهة برمجة تطبيقات التحقق من الإقامة في الولايات المتحدة (AR)
تحقق من بيانات العنوان والإقامة في الولايات المتحدة مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة في الوقت الفعلي، ويتم الفوترة فقط على النتائج الحاسمة. نقطة النهاية، المعلمات، مخطط الاستجابة، التسعير، والتكامل.

تتطلب عملية ضم المستخدمين في الولايات المتحدة التأكد من أنهم من يدعون أنهم. خدمة مجمعة من السجلات الحكومية والعامة، وسجلات الخلفية، والملفات المهنية العامة. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط — وليس أنها حقيقية أو تخص الشخص الذي أمامك. يغلق التحقق من الإقامة في الولايات المتحدة هذه الفجوة عن طريق التحقق من البيانات مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة. يشرح هذا الدليل ما تفعله عملية التحقق، والتفاصيل الفنية الدقيقة، وكيفية دمجها في دقائق.
النقاط الرئيسية:
- ماذا تتحقق منه — يتحقق التحقق من الإقامة في الولايات المتحدة من بيانات العنوان والإقامة مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة.
- ما الذي تحصل عليه —
match_typeمُوحّد بالإضافة إلى نتائج على مستوى الحقل يمكنك توجيهها مباشرة إلى منطق الموافقة / المراجعة / الرفض. - لماذا يهم — يؤكد التحقق من العنوان مقابل البيانات الموثوقة أن مقدم الطلب يعيش بالفعل حيث يدعي — وهي إشارة أساسية لمكافحة الاحتيال والامتثال.
- كيفية استخدامه — طلب
POSTواحد إلى نقطة نهاية التحقق من قاعدة بيانات Didit، أو وحدة سير عمل بدون تعليمات برمجية. 0.54 دولارًا لكل استعلام حاسم، والنتائج في ثوانٍ.
ما الذي يتحقق منه التحقق من الإقامة في الولايات المتحدة
خدمة مجمعة من السجلات الحكومية والعامة، وسجلات الخلفية، والملفات المهنية العامة. تعرض Didit هذه الخدمة من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة وتلقي نتيجة منظمة وموحّدة — وليس تفريغ سجل خام عليك تحليله بنفسك.
تُرجع الاستجابة الحاسمة source_data المطابقة وكتلة validation على مستوى كل حقل، بحيث تحصل محرك المخاطر الخاص بك على حكم واضح قابل للقراءة آليًا.
لماذا يهم
يؤكد التحقق من العنوان مقابل البيانات الموثوقة أن مقدم الطلب يعيش بالفعل حيث يدعي — وهي إشارة أساسية لمكافحة الاحتيال والامتثال.
بالنسبة للشركات المنظمة في الولايات المتحدة — شركات التكنولوجيا المالية، ومنصات العملات المشفرة، والمقرضين، والأسواق، ومشغلي الألعاب — ينتج التحقق من مصدر موثوق سجلًا دفاعيًا وقابلًا للتدقيق يؤكد أن الهوية قد تم تأكيدها من المصدر، وليس مجرد التقاطها من نموذج أو صورة.
التفاصيل الفنية
تعرض Didit هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. وهي عبارة عن POST واحد — لا يتطلب SDK.
نقطة النهاية
POST /v3/database-validation/
معلمات الطلب
| المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
issuing_state | سلسلة نصية | نعم | رمز الدولة ISO 3166-1 alpha-3. استخدم USA. |
services | سلسلة نصية | نعم | معرف الخدمة. استخدم usa_states_residential. |
first_name | سلسلة نصية | نعم | الاسم الأول. |
last_name | سلسلة نصية | نعم | الاسم الأخير. |
date_of_birth | سلسلة نصية | نعم | تاريخ الميلاد. |
address | سلسلة نصية | نعم | العنوان. |
phone | سلسلة نصية | لا | الهاتف (فحص إضافي اختياري). |
ssn | سلسلة نصية | لا | الرقم القومي (فحص إضافي اختياري). |
email | سلسلة نصية | لا | البريد الإلكتروني (فحص إضافي اختياري). |
مثال على الطلب
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=USA" \
-F "services=usa_states_residential" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "address=123 Sample Street, Sample City, 10001"
مثال على الاستجابة (مطابقة حاسمة)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "USA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "usa_states_residential",
"service_name": "United States of America - United States Residential",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"last_name": "Doe",
"name_match_score": "1.000",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value",
"verifications": {
"address": true,
"date_of_birth": true,
"full_name": true
}
},
"validation": {
"address": "full_match",
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}
الأداء والفوترة
- الكمون: عادةً بضع ثوانٍ.
- التكلفة: 0.54 دولارًا لكل استعلام حاسم. يتم فوترتك فقط على النتائج الحاسمة — لا توجد رسوم على تعطل المصدر، أو الحقول المفقودة، أو الرفض قبل المصدر.
- الموثوقية: يعمل على بنية Didit التحتية مع هدف وقت تشغيل ربع سنوي بنسبة 99.9%.
حالات الاستخدام
- التكنولوجيا المالية والبنوك الرقمية — تأكيد وجود صاحب حساب حقيقي وقابل للتحقق قبل فتح محفظة أو تقديم ائتمان في الولايات المتحدة.
- العملات المشفرة و Web3 — تلبية متطلبات ضم VASP مع إثبات هوية من مصدر موثوق.
- الإقراض — تقليل الاحتيال الهوياتي والاحتيال من الطرف الأول باستخدام بيانات تم التحقق منها من المصدر.
- الأسواق ومنصات العمل الحر — التحقق من المستخدمين مقابل البيانات الموثوقة، وليس مجرد نموذج مُبلغ عنه ذاتيًا.
- الألعاب عبر الإنترنت — تلبية فحوصات الهوية والأهلية للاعبين في الولايات المتحدة مع مسار تدقيق.
كيفية التكامل مع Didit
يمكنك تشغيل التحقق من الإقامة في الولايات المتحدة بطريقتين:
- سير عمل بدون تعليمات برمجية. في Didit Business Console، افتح Workflow Builder، أضف وحدة التحقق من قاعدة البيانات، حدد الولايات المتحدة ← التحقق من الإقامة في الولايات المتحدة، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يتطلب أي هندسة.
- واجهة برمجة تطبيقات مباشرة. قم باستدعاء نقطة النهاية
/v3/database-validation/الموضحة أعلاه باستخدامservices=usa_states_residential. اقرأmatch_typeوكتلةvalidationعلى مستوى كل حقل لتشغيل منطق الموافقة / المراجعة / الرفض الخاص بك.
يتضمن كل حساب Didit 500 عملية تحقق مجانية شهريًا، حتى تتمكن من اختبار التدفق بالكامل من البداية إلى النهاية قبل الدفع مقابل استعلام واحد.
الأسئلة المتداولة
ما الذي يؤكده التحقق من الإقامة في الولايات المتحدة؟
يتحقق من البيانات المقدمة مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة ويعيد نتيجة مطابقة موحدة، بحيث تعرف ما إذا كانت بيانات العنوان والإقامة موجودة في المصدر الموثوق وما هي الحقول التي تطابقت.
ماذا يحدث إذا كان المصدر غير متاح مؤقتًا؟
لا يتم محاسبتك. تطبق الفوترة فقط على النتائج الحاسمة — تعطل المصدر، والحقول المفقودة، والرفض قبل المصدر مجانية.
ما مدى سرعة الفحص؟
يتم إرجاع التحقق من قاعدة البيانات عادةً في بضع ثوانٍ، لذلك يتناسب مع سير عمل ضم المستخدمين في الوقت الفعلي.
هل أحتاج إلى SDK؟
لا. الفحص هو POST واحد عبر HTTPS إلى نقطة نهاية واحدة. يمكنك أيضًا ربطه بسير عمل بدون تعليمات برمجية في Business Console.
هل أنت مستعد للبدء؟
تحقق من أول عنوان وبيانات إقامة في الولايات المتحدة اليوم.
- اقرأ مرجع واجهة برمجة التطبيقات: التحقق من الإقامة في الولايات المتحدة
- اطلع على جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
- ابدأ البناء: أنشئ حساب Didit مجانيًا — 500 عملية تحقق شهريًا، مجانًا.