مرجع API

API الخاص بـ ذكاء TLD

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

العمليات

GET /v1/tlds عرض مرجع API
GET /v1/tlds/:tld عرض مرجع API

GET /v1/tlds

العملية: getTlds الوحدات والمصادقة: مجانًا المصادقة اختيارية
GET /v1/tlds

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

المعامل النوع مطلوب
type string
القيم المسموحة gtldcctldnew-gtldidn
اختياري
trust_tier string
القيم المسموحة premiumstandardeconomysuspicious
اختياري
use_case string اختياري

حقول الرد

الحقل النوع
tlds[] object[]
tlds[] object
tlds[].tld string
tlds[].type string
tlds[].name string
tlds[].rdap_supported boolean
tlds[].trust_tier string
tlds[].popularity_rank integer
tlds[].registration_usd number
total integer
by_type object
by_type.gTLD integer
by_type.ccTLD integer
by_type.newTLD integer
by_type.idn integer
by_trust_tier object
by_trust_tier.premium integer
by_trust_tier.standard integer
by_trust_tier.economy integer
use_case string
meta object

طلب مثال

curl "https://domscan.net/v1/tlds?type=example.com&trust_tier=example.com&use_case=startup"

مثال الرد

{
  "tlds": [
    {
      "tld": "com",
      "type": "gTLD",
      "name": "string",
      "rdap_supported": true,
      "trust_tier": "premium",
      "popularity_rank": 1,
      "registration_usd": 1
    }
  ],
  "total": 1,
  "by_type": {
    "gTLD": 1,
    "ccTLD": 1,
    "newTLD": 1,
    "idn": 1
  },
  "by_trust_tier": {
    "premium": 1,
    "standard": 1,
    "economy": 1
  },
  "use_case": "string",
  "meta": {}
}

GET /v1/tlds/:tld

العملية: getTldDetail الوحدات والمصادقة: 1 المصادقة مطلوبة
GET /v1/tlds/:tld

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

المعامل النوع مطلوب
tld string مطلوب

حقول الرد

الحقل النوع
tld string
type string
name string
description string
introduced integer
operator string | null
country string | null
restrictions string
rdap_supported boolean
rdap_endpoint string | null
idn_supported boolean
dnssec_supported boolean
pricing object
pricing.registration_usd number
pricing.renewal_usd number
pricing.transfer_usd number
pricing.currency string
pricing.source string
popularity object
popularity.rank integer
popularity.tier string
popularity.use_cases[] string[]
trust object
trust.score number
trust.tier string
trust.notes string | null
meta object

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/tlds/com"

مثال الرد

{
  "tld": "com",
  "type": "gTLD",
  "name": "string",
  "description": "198.51.100.10",
  "introduced": 1,
  "operator": "string",
  "country": "string",
  "restrictions": "string",
  "rdap_supported": true,
  "rdap_endpoint": "string",
  "idn_supported": true,
  "dnssec_supported": true,
  "pricing": {
    "registration_usd": 1,
    "renewal_usd": 1,
    "transfer_usd": 1,
    "currency": "USD",
    "source": "estimate"
  },
  "popularity": {
    "rank": 1,
    "tier": "top10",
    "use_cases": [
      "string"
    ]
  },
  "trust": {
    "score": 1,
    "tier": "premium",
    "notes": "string"
  },
  "meta": {}
}

موارد المرجع