检查域名可用性 API 参考

Q: 在哪里可以找到 检查域名可用性 的请求和响应参考？

使用 检查域名可用性 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

检查域名在一个或多个 TLD 中是否可用。

同步批量RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

单一决策使用专用检查，需要上下文时再构建更完整的资料。

适合选择此产品的场景

需要带有支持证据的可用、已注册或未知状态时选择。可用结果不保证能够注册。

你将获得什么

检查域名在一个或多个 TLD 中是否可用。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

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
  }
}