API域名验证接口怎么调用：参数、示例与限制说明

作者：佚名时间：2026-10-16 12:05 阅读：128 来源：网络整理

API域名的验证接口, 是让使用者可以通过程序化的操作方式, 对指定的域名进行批量或者单独一条的验证工作。它的作用是查清楚域名的注册状态, 还有DNS解析信息以及所有权的归属情况。

当开发者在做集成系统、部署企业邮箱或者申请SSL证书这些场景的时候, 可以调用这个接口完成自动校验的任务。这样的话, 就不用人工一个一个地去查询了。

接口基本信息

请求地址：https://api.gname.xin/v1/domain/verify

请求方法：POST

认证的这种办法, 其实就是用那种被叫做 Bearer Token 的方式来进行确认, 具体操作的时候, 要在发起请求所携带的包含在里面的头部信息当中, 去把这一行内容给加上进去, 也就是写成 Authorization 这个字段后面跟着冒号, 再加上空格, 然后再写上 Bearer , 最后再接上你自己拥有的那个令牌的具体值。

Authorization: Bearer 。

这种内容的类型是application/json。

响应格式：application/json

请求参数

参数名	类型	必填	说明
domain	string	是	待验证域名API域名验证接口大城群众说事，如 example.com
check_type	string	是	验证类型：registrar（注册状态）、dns（DNS解析）、ownership（所有权）
ip_version	string	否	IP版本，默认 v4，可选 v6

返回结果说明

当出现成功的这种结果的时候, 咱们会返回 HTTP 200 这个状态码, 具体的例子是下面的这样子。

{
  "code": 0,
  "domain": "example.com",
  "check_type": "dns",
  "data": {
    "resolved": true,
    "records": [
      {"type": "A", "value": "93.184.216.34"}
    ]
  },
  "timestamp": "2026-10-16T12:00:00Z"
}

当出现失败的情况时, code 的值不等于零。这时会附带一个字段, 它的名字是 error_msg, 这个字段专门用来说明导致失败的具体原因是怎样一回事儿。

调用示例

curl -X POST "https://api.gname.xin/v1/domain/verify" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","check_type":"dns"}'

使用限制与配额

API域名验证接口怎么调用：参数、示例与限制说明(图1)