API域名验证接口这个玩意儿, 它的主要功能就是对指定域名的注册状态进行实时的校验, 还会同时检查NS记录的情况以及解析是否可用, 这种接口通常被运用到各种各样的场景之中, 比如说在进行网站建设之前要检测一下域名究竟可用不可用, 或者是企业对自己持有的数字资产进行盘点整理的时候, 又或者是需要对大量的域名进行持续监控的场合, 这些都是它适用的地方。

接口基础信息

阜新市自然资源事务服务中心

请求地址：https://api.domainverify.com/v1/verify

请求方法：POST

认证方式：Header 携带 Authorization: Bearer {your_api_key}

数据格式：Content-Type: application/json

请求参数

参数名 类型 必填 说明
domain string 是 待验证域名，如 gname.xin
check_type string 是 验证类型：reg（注册状态）/ ns（NS记录）/ all（全部）
region string 否 指定查询区域API域名验证接口，默认全球

返回字段

字段名 类型 说明
code int 状态码API域名验证接口，0 为成功，非 0 为异常
message string 状态描述
data.domain string 请求的域名
data.is_registered bool 域名是否已注册
data.ns_list array 当前 NS 服务器列表
data.available bool 域名当前是否可注册
data.checked_at string 查询时间（ISO 8601）

调用示例

请求体：

{
  "domain": "gname.xin",
  "check_type": "all"
}

成功返回：

{
  "code": 0,
  "message": "success",
  "data": {
    "domain": "gname.xin",
    "is_registered": true,
    "ns_list": ["ns1.gname.xin", "ns2.gname.xin"],
    "available": false,
    "checked_at": "2026-11-07T15:00:00Z"
  }
}

调用限制与注意事项

API域名验证接口接入指南：参数说明、返回解析与调用示例(图1)

1. 频率限制的内容是这样的, 一个 API Key 在默认的情况之下每秒的请求次数是能够到达 50 的, 如果在批量场景当中需要提高这个额度, 那么是可以去申请提升的。

2. 缓存策略是这样的, 底层在去查 DNS 的时候, 那个动作会被保留长达 30 秒左右的时间。所以, 如果用户在很短的时间内, 再一次去请求同一个域名, 系统很有可能会把之前查好的那个结果, 又给返回回来了, 导致大家得到的答案是一样的。

3. 超时设置: 建议客户端的超时时间不要少于 10 秒, 因为 ICANN WHOIS 以及 DNS 递归查询, 在面对高峰期的时候, 可能会出现几秒钟的延迟。

4. 有一个异常码需要说明, 第一个是code等于4001, 这个表示参数格式存在错误, 第二个是code等于4003, 这个情况对应域名格式不符合规定, 第三个则是code等于5000, 这表明上游的当前服务暂时无法正常提供使用, 对于这种情况建议采取指数退避的方式反复进行尝试。

集成建议

前端轮询, 通过结合available字段, 来实现注册窗口的实时提示功能, 进而避免了用户在完成提交操作之后才会遇到报错的问题。

批量监控的功能是这样的, 我们可以使用region这个参数来进行分区的查询, 这样一来, 每一次请求所花费的时间延迟就会降低。

日志留存: 记录每次的 checked_at 的值, 还有 ns_list 的值。这样做的话, 就方便以后去审计 NS 变更历史了。

本接口文档是随着服务的版本进行更新的。如果想要知晓最新的变更日志情况, 请前往官方开发者中心中进行查阅。