接口基本信息

用户可以使用API的方式去对中文域名的注册状态进行查询, 同时还可以去确认所有权归属的情况, 以及查看解析配置的信息是怎么设置的。这个接口采用的协议是HTTPS, 并且它是支持JSON这种格式的, 也就是说发送请求的时候会用到它, 接收到响应的时候也会用这种格式去呈现结果。

接口地址：https://m.dcqzss.cn/api/domain/query

请求方式：POST

认证方法是使用那个叫做Bearer Token的东西。这个事是通过请求头来操作的。具体点说, 就是在请求头里面携带一个字段。这个字段的名称是Authorization。

这个频率是有限制的, 一个账户每一秒钟之内调用的次数最多不能超过十次, 一旦超过了这个限制, 系统就会返回四二九这个状态码。

请求参数说明

参数名 类型 必填 说明
domain String 是 待查询的中文域名中文域名查询接口，如"好域名.中国"
query_type String 是 查询类型：status / owner / dns
dns_server String 否 指定DNS服务器中文域名查询接口青岛高世电气科技有限公司，不填则用默认服务器
batch Array 否 批量域名列表，单次最多50条

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "domain": "好域名.中国",
    "query_type": "status",
    "status": "registered",
    "registrar": "某某注册局",
    "expire_date": "2025-03-15"
  }
}

返回的状态代码如果是200表示成功, 如果是401说明Token无效, 如果是404表示域名不存在, 如果是429则是请求频率超限, 如果服务端出现异常情况则返回500代码。

接入步骤

中文域名查询接口如何调用？完整接入流程与参数详解(图1)

1. 申请密钥的操作方式是这样的。你要先登录 m.dcqzss.cn 这个网址的管理后台。然后, 你需要进入“API中心”。接下来, 你要点击“创建密钥”这个选项。最后, 你就可以获取到 Access Key 和 Secret Key。

2. 生成Token: 拿现在的这个时间点当时间戳, 用 HMAC 也就是带有密钥的 SHA256 哈希算法对它做一个签名操作, 然后把得到的结果拼接在一起, 这样就形成了一个 Bearer Token。

3. 发起请求: 你要拿着前面说的那几个参数, 去搞一个POST请求。然后呢, 在请求头那边, 把Authorization带着一起传过去。

4. 对响应进行分析, 通过 code 来判断结果, 然后提取 data 中的业务数据。

常见问题

支持哪些中文后缀? 当前阶段是支持 .cn、.中国、.公司、.网络等这些主流后缀的, 如果您想要获取一个完整的列表的话, 是需要调用 /api/domain/suffixes这个接口的。

批量与单条速率区别? 进行50条批量的操作, 其等效结果等同于发出50次数次单条请求的情况, 但是仍然要遵守每秒最多10次的上限约束条件。

是否支持使用Webhook, 答案是肯定的。是否支持Webhook?支持。在发起请求时添加callback_url字段, 当域名状态发生变化的时候会主动推送JSON格式的数据。

合规注意事项

查询的结果只能够被用来在自己的业务系统之内, 不能拿去进行第二次分发的操作, 也不能够去搭建出来一个公开的数据库。

响应数据要保持在有效期之内, 这个有效期是设定为72小时的, 一旦超过了这个时间长度, 就需要重新发起一次请求。

在生产环境之中, 必须得使用HTTPS这个协议, 那个明文的HTTP接口, 从2025年开始, 就要被停用。