تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.
يستخدمه أشخاص في شركات مميزة
إشارات ثقة قبل التكامل
توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.
روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.
تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.
ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.
ما الذي تساعدك هذه الواجهة على إطلاقه
استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.
ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.
استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.
استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.
زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.
سير عمل التكامل
مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.
أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.
ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.
استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.
عدة المطور
انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.
خريطة المعلمات والاستجابة
راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.
المعامل
مثال الرد
رموز حالة HTTP
نقاط النهاية
/v1/phone/validate
/v1/phone/validate/bulk
تحقق أولًا. ادفع مقابل بيانات الاتصالات المباشرة فقط عند الحاجة.
تتولى DomScan المرحلة الأولى عبر التحقق وفق خطة الترقيم والتنسيقات القياسية والبيانات الوصفية غير المتصلة بالإنترنت وأدلة النطاقات أو البادئات الرسمية حيثما تتوفر. رشّح الأرقام ووجّهها أولًا، ثم أضف خدمة مباشرة منفصلة فقط عندما يعتمد القرار على بيانات شركة الاتصالات الحالية أو نقل الرقم أو قابلية الوصول أو التحقق المصرح به من الهوية أو مؤشرات الاحتيال الخاصة بمزوّد الخدمة.
نفّذ فحوص خطة الترقيم الروتينية على كل رقم قبل تحديد السجلات التي تستحق إجراء بحث مباشر على الشبكة.
يتحقق DomScan من التنسيق والنطاقات الموثقة والبيانات الوصفية غير المتصلة بالإنترنت. الموقع هو منطقة في خطة الترقيم وليس موضعًا فعليًا. شركة الاتصالات أو الجهة الحاصلة على التخصيص هي الارتباط الأصلي بالنطاق، وليست بالضرورة شركة الاتصالات الحالية بعد نقل الرقم. لا تؤكد النتيجة التخصيص أو النشاط أو إمكانية الوصول أو تسليم رسائل SMS أو هوية المشترك.
عندما تتوفر التغطية، اطّلع على حالة النطاق المطابق والجهة التي حصلت على التخصيص الأصلي مع تفاصيل المصدر واللقطة. تصف هذه البيانات نطاقًا ولا تحدد شركة الاتصالات الحالية أو المشترك.
إشارات ثقة قبل التكامل
توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.
روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.
تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.
ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.
ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.
الميزات الرئيسية
تحقق من الطول وأنماط الأرقام بالاستناد إلى البيانات الوصفية الكاملة لخطة الترقيم، وليس إلى الطول وحده.
احصل على تنسيقات E.164 والدولي والوطني وRFC 3966، بما في ذلك الأرقام الداخلية بعد تحليلها.
ميّز الأرقام ذات الطول المحتمل عن النطاقات التي تتعرف عليها خطة الترقيم.
حدد نوع الرقم وموقع خطة الترقيم والمناطق الزمنية المحتملة وشركة الاتصالات الأصلية ودعم قابلية نقل الرقم عندما تتضمن البيانات الوصفية هذه المعلومات.
حلّل الأرقام الوطنية مع تحديد البلد، وأنشئ تنسيقات اتصال مخصصة لبلد المنشأ، وتعرّف على الأرقام المختصرة الإقليمية وأرقام الطوارئ.
تحقق من ما يصل إلى 100 رقم في كل طلب مع نتيجة مستقلة لكل قيمة مدخلة.
عندما تتوفر التغطية، اطّلع على حالة النطاق المطابق والجهة التي حصلت على التخصيص الأصلي مع تفاصيل المصدر واللقطة. تصف هذه البيانات نطاقًا ولا تحدد شركة الاتصالات الحالية أو المشترك.
طلب مثال
curl -X POST https://domscan.net/v1/phone/validate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'
مثال الرد
{
"input": "+34 612 345 678",
"normalized_input": "+34 612 345 678",
"kind": "phone_number",
"valid": true,
"possible": true,
"status": "valid",
"recommendation": "accept",
"validation_level": "numbering_plan",
"reason": null,
"warnings": [],
"number": {
"e164": "+34612345678",
"international": "+34 612 34 56 78",
"national": "612 34 56 78",
"rfc3966": "tel:+34612345678",
"national_number": "612345678",
"extension": null,
"country": "ES",
"country_name": "Spain",
"country_calling_code": "34",
"possible_countries": ["ES"],
"country_match": true,
"type": "mobile",
"non_geographic": false
},
"intelligence": {
"status": "available",
"kind": "phone_number",
"coverage": {
"country": "ES",
"level": "official_allocation_match",
"global_numbering_metadata": true,
"official_snapshot_available": true,
"official_allocation_match": true,
"official_source_ids": ["cnmc"],
"matching_source_ids": ["cnmc"],
"current_carrier_lookup": false
},
"location": {
"country_name": "Spain",
"country": "ES",
"granularity": "country",
"current_physical_location": false
},
"possible_time_zones": {
"values": ["Europe/Madrid"],
"current_location": false,
"inference": "number_prefix"
},
"original_prefix_carrier": {
"name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"source_id": "cnmc",
"evidence": "official_allocation_record",
"current_carrier": false,
"portability_may_change_carrier": true
},
"portability": {
"region_supported": true,
"current_port_checked": false
},
"dialing": {
"from_country": "US",
"international": "011 34 612 34 56 78",
"internationally_diallable": true
},
"regulator_allocations": [{
"authority": "CNMC",
"category": "mobile",
"status": "assigned",
"original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"assigned_on": "2023-11-03",
"current_operator": false,
"individual_number_assignment_checked": false
}],
"sources": [{
"id": "google_libphonenumber",
"name": "Google libphonenumber metadata",
"license": "Apache-2.0"
}, {
"id": "cnmc",
"name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
"type": "official_regulator_snapshot"
}]
},
"live_checks": {
"assignment": "not_checked",
"reachability": "not_checked",
"current_carrier": "not_checked",
"subscriber_identity": "not_checked",
"porting": "not_checked"
},
"privacy": {
"upstream_requests": 0,
"telecom_provider_queried": false,
"persisted": false,
"domscan_edge_relay_used": true,
"third_party_requests": 0
},
"limitations": [
"NUMBERING_PLAN_ONLY",
"DOES_NOT_PROVE_ASSIGNMENT",
"NO_LIVE_TELECOM_CHECKS"
],
"credits_used": 1
}
الأسئلة الشائعة
تعني النتيجة الصالحة أن الرقم يطابق الطول وأنماط الأرقام الموثقة لنطاق معترف به في خطة الترقيم. ولا تعني أن الرقم مخصص لمشترك.
لا. لا يستطيع التحقق وفق خطة الترقيم تأكيد أن الرقم مخصص أو نشط أو يمكن الوصول إليه أو قادر على استقبال المكالمات أو رسائل SMS.
قد تعرض API شركة الاتصالات الأصلية لنطاق الرقم أو الجهة الحاصلة على التخصيص التنظيمي. لا يشير أي من الحقلين إلى شركة الاتصالات الحالية بعد نقل الرقم، ولا يحدد أي منهما هوية المشترك أو مالك الهاتف.
نعم. حدد بلدًا أو منطقة افتراضية عندما لا يبدأ الرقم برمز اتصال دولي. كما يلزم تحديد البلد لتفسير الأرقام المختصرة الإقليمية وأرقام الطوارئ.
نعم. تقبل نقطة النهاية المجمّعة ما يصل إلى 100 رقم وتعرض النتائج بترتيب الإدخال. إذا تعذر الإثراء غير المتصل بالإنترنت، يستمر التحقق المحلي وتعرض intelligence.status حالة الاستمرارية.
الأدوات والموارد ذات الصلة
رموز حالة HTTP
نوثّق رموز حالة HTTP التي يجب على عميلك التعامل معها حتى تتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات غير الموجودة وأعطال الخدمة الخارجية.
نجح الطلب
معلمات غير صالحة
مفتاح API أو الجلسة مفقود أو غير صالح.
لا توجد أرصدة كافية لتنفيذ هذا الطلب.
تم تجاوز حد المعدل
خطأ داخلي
جرّب معلومات أرقام الهاتف مجانًا