API الخاص بـ ذكاء TLD
احصل على ذكاء مفصل عن TLD بما في ذلك التسعير والقيود ودعم المسجل والإحصائيات الاستخدام. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.
العمليات
GET /v1/tlds
GET
/v1/tlds
الرصيد: 0
معاملات الاستعلام
| المعامل | النوع | مطلوب |
|---|---|---|
| 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=gtld&trust_tier=premium&use_case=startup"const response = await fetch("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup");
const data = await response.json();
console.log(data);import requests
response = requests.get(
"https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup",
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup", nil)
if err != nil {
panic(err)
}
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup")
request = Net::HTTP::Get.new(uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))مثال الرد
{
"tlds": [
{
"tld": "com",
"type": "gTLD",
"name": "example",
"rdap_supported": false,
"trust_tier": "premium",
"popularity_rank": 1,
"registration_usd": 0.5
}
],
"total": 1,
"by_type": {
"gTLD": 1,
"ccTLD": 1,
"newTLD": 1,
"idn": 1
},
"by_trust_tier": {
"premium": 1,
"standard": 1,
"economy": 1
},
"use_case": "example",
"meta": {}
}
رموز حالة HTTP
200OK429طلبات كثيرة جداً
GET /v1/tlds/:tld
GET
/v1/tlds/:tld
الرصيد: 1
معاملات الاستعلام
| المعامل | النوع | مطلوب |
|---|---|---|
| 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"const response = await fetch("https://domscan.net/v1/tlds/com", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/tlds/com",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds/com", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/tlds/com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))مثال الرد
{
"tld": "com",
"type": "gTLD",
"name": "Commercial",
"description": "The most popular and trusted domain extension worldwide",
"introduced": 1985,
"operator": "Verisign",
"restrictions": "None - open registration",
"rdap_supported": true,
"rdap_endpoint": "https://rdap.verisign.com/com/v1/",
"idn_supported": true,
"dnssec_supported": true,
"pricing": {
"registration_usd": 12,
"renewal_usd": 12,
"transfer_usd": 12,
"currency": "USD",
"source": "market_average"
},
"popularity": {
"rank": 1,
"tier": "top10",
"use_cases": [
"business",
"personal",
"startup",
"enterprise",
"tech",
"e-commerce",
"blog",
"portfolio"
]
},
"trust": {
"score": 100,
"tier": "premium",
"notes": "Most trusted TLD globally"
},
"meta": {
"served_by": "pop=MAD country=ES"
}
}
رموز حالة HTTP
200OK401غير مصرح402الدفع مطلوب404غير موجود429طلبات كثيرة جداً