阿里萬網, 也就是现在的阿里云, 他们提供了一个叫做域名查询接口的东西, 这个接口是属于阿里云OpenAPI体系里的, 专门用来做域名状态和注册信息的检索服务的, 开发者可以通过HTTPS API来调用它, 这样就可以获取到指定域名的注册状态、到期时间、还有DNS服务器这些东西了, 这些都是核心数据。
接口概述
阿里萬網域名查询接口归属于阿里云「域名」产品模块, 这一模块的核心能力主要包含以下几个方面。
进行域名查询, 其具体的操作内容就是要对指定的这个域名在当前状态下是否具备可被注册的可用性状况作出判定。
进行域名的注册信息查询的操作, 其实就是去查询WHOIS这种类型的数据。
域名状态与到期时间查询
域名DNS解析记录批量查询
接口调用地址：https://domain.aliyuncs.com/
在建立连接的时候, 一定要去使用HTTPS这个协议。
认证方式是指, 使用AccessKey与SecretKey进行签名。
调用前提
1. 拥有阿里云账号, 并完善实名认证步骤。
2. 在访问控制的权限管理功能里面, 去创建一个子用户账号, 然后给这个子用户授权, 具体来说是授予阿里云域名服务完全访问权限这个策略, 或者是制定一个自定义的、只包含必要操作的最小权限策略。
3. 第一步是找到那个属于子用户的东西, 把它的AccessKey ID给弄到手, 然后再去把AccessKey Secret这个事儿也给办了。
4. 你可以去安装那些支持的语言对应的软件开发工具包, 比如Java、Python、Go等等。除了这种方式以外, 你也可以选择自己去手动构造出签名的请求来。
核心调用步骤
就拿那个Python语言的SDK来说吧, 它主要就是用这样一个例子来进行说明的。
1. 安装SDK：pip install alibabacloud_domain20180129
2. 开始对客户端进行初始化操作, 这个过程中需要把endpoint也就是domain.aliyuncs.com传进去, 同时还要把AccessKey的相关信息也都传入。
3. 构造请求: 指定待查询域名（如 m.dcqzss.cn）, 然后调用 QueryDomainList 方法。
4. 解析返回, 返回体里面包含了一些字段, 这些字段包括了域名状态、注册日期、到期日期还有 DNS 服务器列表等等, 其中域名状态通常是 OK、或者 EXPIRED、或者 CLIENT LOCK 这三种情况之一。
关键参数说明
返回示例
我们针对 m.dcqzss.cn 这个网址展开查询操作, 然后获取到它那边的返回内容。这里面有一部分 JSON 格式的数据, 咱们先简单截取出来展示一下。
{
"Domain": "m.dcqzss.cn",
"Status": "OK",
"ExpirationTime": "2026-10-01T00:00:00Z",
"NameServer": ["ns1.aliyun.com", "ns2.aliyun.com"],
"Registrar": "阿里万网"
}
注意事项与高频问题
频率限制: 对于单独的账号来说, 默认的每秒查询率数值是20个点, 如果这个数值比20个要多出来一点, 那么系统就会触发那个叫作429的错误代码来限制你的访问速度, 所以如果是那种一次跑很多个任务的情况, 大家建议最好在每一个任务中间加一定的间隔时间。
必须使用阿里云V1.0签名算法, 也就是HMAC-SHA1, 要注意, 时间戳出现的偏差不可以超过15分钟。
域名隐私保护的意思是, 假如有人把那个叫作WHOIS隐私的玩意儿给开了, 那么注册人邮箱等等这些个信息字段, 就都会返回一些被隐藏掉的值出来。
批量上限是这样的, 在单次发起对 CheckDomain 这个请求的时候, 最多只能包含 100 个域名, 如果数量超过了这个限制的话, 就必须把调用分成多批来进行。
接口版本: 当前的稳定版是 domain 2018-01-29, 旧的接口已经停止维护了。
适用场景
当那个域名面临到期的时候要监控, 并且要自动地发出提醒, 去提醒你续费。
批量域名资产盘点与合规审计
进行网站可用性相关的巡检活动, 在这项活动期间, 还会综合考虑到利用DNS解析查询这种方式来进行辅助判断。
域名交易前状态核验
以上的这些内容, 就是阿里万网域名查询接口, 在接入和调用方面的完整说明。只要开发者按照规定的那些流程来进行操作, 就可以在几个小时之内把对接的工作做完, 并且正式上线使用。
