本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
请先阅读基础的解析单个域名文档,该文档中有关于HTTPDNS访问接口的整体描述和接入注意事项说明。
本文档只描述“批量解析API接口”请求和响应格式相关的部分。
1. API请求格式
警告
使用HTTP API时,务必遵循风险防范建议,否则存在业务故障风险。
请求方式:GET
服务URL:http://203.107.XXX.XXX/{account_id}/resolve
(服务IP列表请参考获取解析服务地址)
URL参数说明:
名称 | 是否必须 | 描述 |
host | 必须 | 要解析的域名,多个域名之间以逗号 |
ip | 可选 | 用户的来源IP,如果没指定这个参数,默认使用请求连接的源IP。如果指定来源IP,允许指定一个或多个IP,多个IP之间以逗号 |
请求示例:
解析多个域名:http://203.107.XXX.XXX/100000/resolve?host=www.aliyun.com,www.taobao.com
指定多个来源IP:http://203.107.XXX.XXX/100000/resolve?host=www.aliyun.com&ip=42.120.XXX.XXX,218.16.XXX.XXX
注意,单次请求中,不允许同时解析多个域名并且指定多个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。返回结果其他各字段的含义,请参考解析单个域名中的描述。
文档内容是否对您有帮助?