批量域名解析接口
请先阅读基础的单域名解析接口文档,该文档中有关于HTTPDNS访问接口的整体描述和接入注意事项说明。
本文档只描述“批量解析API接口”请求和响应格式相关的部分。
1. API请求格式
请求方式:HTTP GET
或HTTPS GET
服务URL:http://203.107.1.33/{account_id}/resolve
URL参数说明:
名称 |
是否必须 |
描述 |
host |
必须 |
要解析的域名,多个域名之间以逗号 |
ip |
可选 |
用户的来源IP,如果没指定这个参数,默认使用请求连接的源IP。如果指定来源IP,允许指定一个或多个IP,多个IP之间以逗号 |
请求示例:
解析多个域名:http://203.107.1.33/100000/resolve?host=www.aliyun.com,www.taobao.com
指定多个来源IP:http://203.107.1.33/100000/resolve?host=www.aliyun.com&ip=42.120.74.99,218.16.248.58
注意,单次请求中,不允许同时解析多个域名并且指定多个IP。批量解析的域名和IP都有个数限制,如有超出限制的需求,请提工单沟通。
2. API响应格式
解析结果JSON格式示例如下:
{
"dns": [
{
"host": "www.aliyun.com",
"client_ip": "192.168.xx.xx",
"ips": [
"192.168.xx.xx"
],
"ttl": 106,
"origin_ttl": 120
},
{
"host": "www.taobao.com",
"client_ip": "192.168.xx.xx",
"ips": [
"192.168.xx.xx"
],
"type":1 // 1代表IPv4,28代表IPv6
"ttl": 46,
"origin_ttl": 60
}
]
}
批量解析接口的返回内容中包含client_ip
字段,表示客户端来源IP。返回结果其它各字段的含义,请参考单域名解析接口中的描述。