API域名验证接口接入指南：参数说明与调用示例

作者：佚名时间：2026-10-22 15:13 阅读：163 来源：网络整理

API域名验证接口这个说法, 在大家看来它主要是做两件事情, 一件是给域名的归属权做一个检验, 另一件就是去查询它的注册状态。

那些选择接入这个接口的人, 可以通过它来实时的搞清楚指定的那个名字到底是谁在持有着, 还有DNS这种记录现在的状态是怎么样的, 同时也能看到由ICANN那边给出的相关的注册信息。

因为这个东西的这些功能特点, 所以它在一些特别具体的环节里被用到了, 比如一个网站的准备工作还没做完之前需要确认域名究竟属于谁的时候用得上, 又或者手里有一大堆域名需要定期去进行资产方面的检查和维护操作时用得上, 再或者是在设置CDN服务的过程中需要去核对配置信息是否准确无误的时候也用得上。

接口基本信息

接口地址：/v1/domain/verify

提交数据的方式需要使用的是POST。

认证方式是通过在请求头里面添加Authorization字段, 并且这个字段的值是Bearer加上一个小于号, 然后是你的API密钥, 然后再加一个大于号。

数据格式：application/json

调用频率受到限制, 具体的数值为默认每分钟 100 次。

请求参数

参数名	类型	必填	说明
domain	string	是	待验证域名，如 gname.xin
verify_type	string	是	验证类型大城群众说事，枚举值：ownership（归属权）、dns（解析记录）、status（注册状态）
dns_records	array	否	当 verify_type 为 dns 时，指定待校验的 DNS 记录类型（A/AAAA/CNAME/MX/TXT）
iccid	string	否	指定注册局，用于限定查询范围

调用示例

POST /v1/domain/verify
{
  "domain": "gname.xin",
  "verify_type": "ownership",
  "iccid": "REGISTRY_CN"
}

返回：

{
  "code": 0,
  "message": "success",
  "data": {
    "domain": "gname.xin",
    "registry": "REGISTRY_CN",
    "owner_masked": "xxx*xin",
    "status": "ACTIVE",
    "verified_at": "2026-10-22T14:30:00Z"
  }
}

返回码说明

0: 经过验证, 确认是通过。

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