الهوية والتحقق 2 نقاط النهاية 7 الميزات الرئيسية

واجهة API لـ معلومات أرقام الهاتف

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

Category الهوية والتحقق
نقاط النهاية 2
الميزات الرئيسية 7
الأسئلة الشائعة 5

يستخدمه أشخاص في شركات مميزة

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

10,000 حصة مجانية

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

ما الذي تساعدك هذه الواجهة على إطلاقه

استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.

سير عمل المنتج

ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.

أتمتة المحللين

استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.

بيانات JSON نظيفة

استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.

أدوات الذكاء الاصطناعي والعمليات

زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.

سير عمل التكامل

مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.

1
المصادقة مرة واحدة

أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.

2
الاستعلام باستخدام الأمثلة

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

3
التشغيل والمراقبة

استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.

عدة المطور

انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.

خريطة المعلمات والاستجابة

راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.

معلمات الطلب

المعامل

phonedefault_countryexpected_countrydialing_from_countrylanguagephones
حقول الاستجابة

مثال الرد

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164
تغطية الحالة

رموز حالة HTTP

200400401402429500

نقاط النهاية

POST /v1/phone/validate
الرصيد: 1المصادقة: المصادقة مطلوبة
phonedefault_countryexpected_countrydialing_from_countrylanguage
POST /v1/phone/validate/bulk
الرصيد: 1/itemالمصادقة: المصادقة مطلوبة
phonesdefault_countryexpected_countrydialing_from_countrylanguage

تحقق أولًا. ادفع مقابل بيانات الاتصالات المباشرة فقط عند الحاجة.

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

رصيد واحد لكل رقم

نفّذ فحوص خطة الترقيم الروتينية على كل رقم قبل تحديد السجلات التي تستحق إجراء بحث مباشر على الشبكة.

لا استعلام اتصالات لكل رقم

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

سياق التخصيص الرسمي

عندما تتوفر التغطية، اطّلع على حالة النطاق المطابق والجهة التي حصلت على التخصيص الأصلي مع تفاصيل المصدر واللقطة. تصف هذه البيانات نطاقًا ولا تحدد شركة الاتصالات الحالية أو المشترك.

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

حالة الخدمة ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

حصة مجانية اشترك مجاناً

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

نشط طلب مثال

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

الميزات الرئيسية

تحقق صارم وفق خطة الترقيم

تحقق من الطول وأنماط الأرقام بالاستناد إلى البيانات الوصفية الكاملة لخطة الترقيم، وليس إلى الطول وحده.

تنسيقات موحّدة

احصل على تنسيقات E.164 والدولي والوطني وRFC 3966، بما في ذلك الأرقام الداخلية بعد تحليلها.

التمييز بين المحتمل والصالح

ميّز الأرقام ذات الطول المحتمل عن النطاقات التي تتعرف عليها خطة الترقيم.

نوع الرقم ومعلومات البادئة

حدد نوع الرقم وموقع خطة الترقيم والمناطق الزمنية المحتملة وشركة الاتصالات الأصلية ودعم قابلية نقل الرقم عندما تتضمن البيانات الوصفية هذه المعلومات.

الاتصال حسب البلد والأرقام المختصرة

حلّل الأرقام الوطنية مع تحديد البلد، وأنشئ تنسيقات اتصال مخصصة لبلد المنشأ، وتعرّف على الأرقام المختصرة الإقليمية وأرقام الطوارئ.

التحقق دفعة واحدة

تحقق من ما يصل إلى 100 رقم في كل طلب مع نتيجة مستقلة لكل قيمة مدخلة.

مصادر غير متصلة وتخصيصات رسمية

عندما تتوفر التغطية، اطّلع على حالة النطاق المطابق والجهة التي حصلت على التخصيص الأصلي مع تفاصيل المصدر واللقطة. تصف هذه البيانات نطاقًا ولا تحدد شركة الاتصالات الحالية أو المشترك.

طلب مثال

POST /v1/phone/validate bash
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"}'

مثال الرد

200 OK json
{
  "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 شركة الاتصالات الحالية أو مالك الهاتف؟

قد تعرض API شركة الاتصالات الأصلية لنطاق الرقم أو الجهة الحاصلة على التخصيص التنظيمي. لا يشير أي من الحقلين إلى شركة الاتصالات الحالية بعد نقل الرقم، ولا يحدد أي منهما هوية المشترك أو مالك الهاتف.

هل تتطلب أرقام الهاتف الوطنية تحديد بلد؟

نعم. حدد بلدًا أو منطقة افتراضية عندما لا يبدأ الرقم برمز اتصال دولي. كما يلزم تحديد البلد لتفسير الأرقام المختصرة الإقليمية وأرقام الطوارئ.

هل يمكنني التحقق من أرقام الهاتف دفعة واحدة؟

نعم. تقبل نقطة النهاية المجمّعة ما يصل إلى 100 رقم وتعرض النتائج بترتيب الإدخال. إذا تعذر الإثراء غير المتصل بالإنترنت، يستمر التحقق المحلي وتعرض intelligence.status حالة الاستمرارية.

الأدوات والموارد ذات الصلة

رموز حالة HTTP

نوثّق رموز حالة HTTP التي يجب على عميلك التعامل معها حتى تتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات غير الموجودة وأعطال الخدمة الخارجية.

OK 200

نجح الطلب

طلب غير صالح 400

معلمات غير صالحة

غير مصرح 401

مفتاح API أو الجلسة مفقود أو غير صالح.

الدفع مطلوب 402

لا توجد أرصدة كافية لتنفيذ هذا الطلب.

طلبات كثيرة جداً 429

تم تجاوز حد المعدل

خطأ في الخادم 500

خطأ داخلي

جرّب معلومات أرقام الهاتف مجانًا