适用对象
单一决策使用专用检查，需要上下文时再构建更完整的资料。
你将获得什么
检查域名在一个或多个 TLD 中是否可用。
同步批量RESTMCPSDK交互式工具
适合选择此产品的场景
适合选择此产品的场景
需要带有支持证据的可用、已注册或未知状态时选择。可用结果不保证能够注册。
你将获得什么
检查域名在一个或多个 TLD 中是否可用。
端点
集成前，请查看支持的操作、输入、输出、执行模式和响应限制。
积分和身份验证
1 需要身份验证。有关确切费用和按项计费，请查看操作参考。
操作示例
使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。
GET
/v1/status
积分: 1
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| name | string | 可选 |
| tlds | string | 可选 |
| domain | string | 可选 |
| prefer_cache |
boolean
默认值
false
|
可选 |
响应字段
| 字段 | 类型 |
|---|---|
cache_age_s |
integer |
name |
string |
results[] |
object[] |
results[] |
object |
results[].classification |
object |
results[].classification.status |
string |
results[].classification.reason |
string |
results[].classification.evidence |
object |
results[].classification.evidence.source |
string |
results[].classification.evidence.method |
string |
results[].classification.evidence.observed_at |
string |
results[].classification.evidence.detail |
string |
results[].classification.checked_at |
string |
results[].domain |
string |
results[].tld |
string |
results[].available |
boolean | null |
results[].availability_reason |
string |
results[].source |
string |
results[].confidence |
string |
results[].checked_at |
string |
results[].latency_ms |
integer |
results[].cache_age_s |
integer |
results[].registry_status[] |
string[] |
results[].rdap_events[] |
object[] |
results[].rdap_events[] |
object |
results[].rdap_events[].eventAction |
string |
results[].rdap_events[].eventDate |
string |
results[].proof |
object |
results[].dns_status |
object |
results[].dns_status.has_nameservers |
boolean |
results[].dns_status.resolvable |
boolean |
results[].dns_status.checked |
boolean |
results[].timing |
object |
results[].timing.cache_lookup_ms |
integer |
results[].timing.rdap_query_ms |
integer |
results[].timing.dns_check_ms |
integer |
results[].timing.total_ms |
integer |
results[].status_flags[] |
string[] |
results[].status |
string |
results[].lifecycle_phase |
string |
results[].is_public_suffix |
boolean |
results[].error |
object |
results[].error.code |
string |
results[].error.message |
string |
results[].error.suggestion |
string |
results[].error.cause |
string |
scope |
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.restricted_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 |
meta.served_by |
string |
meta.scope_description |
string |
请求示例
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"const response = await fetch("https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false", {
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/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false",
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/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false", 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/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false")
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))响应示例
{
"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
}
}HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多
常见问题
在哪里可以找到 检查域名可用性 的请求和响应参考？
使用 检查域名可用性 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。
应如何解读 检查域名可用性 返回的未知或不完整结果？
未知或部分结果表示无法完全确定所请求的证据。在后续决策中保留结果状态、置信度、新鲜度和限制信息。
检查域名可用性 如何计费？
费用取决于操作和执行模式。有关当前积分费用、身份验证要求和按项规则，请查看端点参考。
