这个用于通过程序化方式来校验指定域名的注册状态, DNS解析信息以及所有权归属的API域名验证接口。在调用之后会即时返回结构化的JSON结果。这种功能非常适用于批量域名监控, 备案核验以及资产安全审计等多个场景, 并且支持GET与POST两种请求方式。

接口基本信息

接口端点：https://api.gname.xin/v1/domain/verify

请求这个方法, 通常是用GET啊, 或者也可以去用POST。

认证的这种办法, 就是使用 Bearer Token, 然后把这个东西放到请求头里面的 Authorization那个字段里面去。

响应格式：application/json

关于频率的限制方面, 是每一个单独的Token每分钟内最多可以使用一百次, 如果超过了这个限制的话, 就会返回 HTTP 429 这样的状态码。

请求参数

参数名 类型 必填 说明
domain string 是 待验证完整域名API域名验证接口API域名验证接口，如 example.com
check_type string 是 验证类型：registration / dns / ownership
ip_version string 否 DNS查询协议灵音心图，默认v4，可选v6
callback_url string 否 填写后切换为异步回调模式

调用流程

1. 获取凭证: 你需要在管理后台里面去创建一个应用, 这个操作会生成API Key和Secret, 然后你要把这两个东西拼接在一起, 最终得到Bearer Token。

2. 构造请求就是把域名和参数填到那个URL的查询字符串里, 这适用于GET方法, 或者把内容放到请求体当中去, 这对于POST方法是适用的。

3. 发送调用: 你可以使用curl, 还可以使用各种各样语言的HTTP客户端去发出请求。

API域名验证接口怎么调用？参数与流程一次讲清(图1)

4. 对响应内容来进行解析, 具体做法是去读取code这个字段的值, 如果该值为0就代表处理成功, 如果该值不等于0就要按照错误码所对应的规定来处理。

5. 当出现异常处理的情况时, 1001表示域名不存在, 1002表示TOKEN无效, 1003表示频率超限, 需要按照预定的策略重新进行尝试。

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "domain": "example.com",
    "registration": "active",
    "registrar": "Registry Inc.",
    "dns_records": ["A", "AAAA", "MX", "TXT"],
    "verified_at": "2026-10-16T09:00:00Z"
  }
}

注意事项与常见问题

输入的域名一定要是那种完整的格式, 这个完整格式里面得包含主域名的信息, 系统是不支持直接使用纯IP地址的, 同时也不允许只填写一个子路径的内容。

一次请求最多可以携带50个域名的相关信息, 如果超出这个数量, 需要分批提交。

这个接口会默认返回在300秒以内的缓存结果；如果你需要获得实时的数据, 你必须追加一个cache=false的参数。

在进行开发的调试过程之时, 我们可以将端点切换成分名为xinyin那个所提供的用于沙箱运作的环境, 这样做能够确保不会对生产数据带来相应的干扰。

调用方必须进行遵守《域名注册管理规则》这个事儿在手上, 然后验证数据留存的时间长度不能超出180天这个界限。

快速接入

您需要先去那个官方开放的平台的控制台那里去完成应用的注册, 然后再去把密钥的配置给弄好, 这个东西整个过程大概需要用掉5分钟的时间。

那个平台上面会提供出来包括Python、Java、Go、Node.js这样四种语言的SDK以及完整的示例代码在这里边供您使用, 您就根据您自己的项目所采用的语言, 然后去选择相对应的那个版本, 就可以完成集成了。