منتج API الخاص بـ فحص توفر المجال

ما الذي تحصل عليه

تحقق مما إذا كان اسم مجال متاحًا عبر واحد أو أكثر من TLDs.

متزامنمجمّعRESTMCPSDKأداة تفاعلية

اختر هذا المنتج عندما

لمن صُمم هذا المنتج

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

اختر هذا المنتج عندما

اختره لحالة متاح أو مسجل أو غير معروف مع دليل داعم. لا يضمن التوفر إمكانية التسجيل.

ما الذي تحصل عليه

تحقق مما إذا كان اسم مجال متاحًا عبر واحد أو أكثر من TLDs.

نقاط النهاية

راجع العمليات والمدخلات والمخرجات وأنماط التنفيذ وحدود الاستجابة المدعومة قبل التكامل.

GET /v1/status عرض مرجع API

POST /v1/status/bulk عرض مرجع API

الوحدات والمصادقة

1 المصادقة مطلوبة. راجع مرجع العملية لمعرفة التكلفة الدقيقة وتسعير كل عنصر إن وُجد.

مثال على عملية

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

GET /v1/status

معاملات الاستعلام

المعامل	النوع	مطلوب
name	string	اختياري
tlds	string	اختياري
domain	string	اختياري
prefer_cache	boolean الافتراضي `false`	اختياري

حقول الرد

الحقل	النوع
`name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].tld`	string
`results[].available`	boolean \| null
`results[].source`	string
`results[].confidence`	string
`results[].checked_at`	string
`results[].latency_ms`	integer
`results[].error`	string
`confidence_summary`	object
`confidence_summary.scope`	string
`confidence_summary.requested_count`	integer
`confidence_summary.result_count`	integer
`confidence_summary.invalid_count`	integer
`confidence_summary.available_count`	integer
`confidence_summary.registered_count`	integer
`confidence_summary.authoritative_count`	integer
`confidence_summary.heuristic_count`	integer
`confidence_summary.cached_count`	integer
`confidence_summary.error_count`	integer
`confidence_summary.ambiguous_count`	integer
`confidence_summary.source_counts`	object
`confidence_summary.primary_source`	string \| null
`confidence_summary.cache_status`	string
`confidence_summary.rdap_calls`	integer
`confidence_summary.refreshes`	integer
`confidence_summary.cache_preference_misses`	integer
`confidence_summary.fallback_chain[]`	string[]
`confidence_summary.confidence_level`	string
`confidence_summary.determinacy_rate`	number
`confidence_summary.ambiguity_reason`	string \| null
`meta`	object
`meta.total_checked`	integer
`meta.available_count`	integer
`meta.duration_ms`	integer

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false"

مثال الرد

{
  "name": "mycompany",
  "results": [
    {
      "domain": "mycompany.com",
      "tld": "com",
      "available": false,
      "source": "rdap",
      "latency_ms": 45
    },
    {
      "domain": "mycompany.io",
      "tld": "io",
      "available": true,
      "source": "rdap",
      "latency_ms": 67
    }
  ],
  "meta": {
    "total_checked": 2,
    "available_count": 1,
    "duration_ms": 120
  }
}

الحدود وحدود الأدلة

تعني الحالة غير المعروفة تعذر تحديد الحقيقة المطلوبة من الأدلة المتاحة.

تعالج العمليات المجمعة مدخلات متعددة مع الحفاظ على النتائج الموثقة لكل عنصر.

تعني الحالة المخزنة استخدام أدلة محفوظة؛ راجع بيانات الحداثة عند توفرها.

قد تتغير الأدلة بمرور الوقت؛ استخدم الطوابع الزمنية وحقول الحداثة عند توفرها.

لا تثبت نتيجة الغياب أو عدم المعرفة إمكانية المطالبة بالمعرّف أو تسجيله.

تمت المراجعة في 2026-08-22

منتجات ذات صلة

الأسئلة الشائعة

أين أجد مرجع طلب واستجابة فحص توفر المجال؟

استخدم مرجع API الخاص بـ فحص توفر المجال لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.

كيف أفسر النتائج غير المعروفة أو غير المكتملة من فحص توفر المجال؟

تعني النتائج غير المعروفة أو الجزئية أن الأدلة المطلوبة لم تُحسم بالكامل. احتفظ بحالة النتيجة ومستوى الثقة والحداثة والحدود عند اتخاذ القرارات اللاحقة.

كيف يتم احتساب سعر فحص توفر المجال؟

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