批量域名解析接口API的请求格式以及响应格式_移动研发平台(EMAS)-阿里云帮助中心

请先阅读基础的单域名解析接口文档，该文档中有关于HTTPDNS访问接口的整体描述和接入注意事项说明。

本文档只描述“批量解析API接口”请求和响应格式相关的部分。

1. API请求格式

警告

使用HTTP API时，务必遵循风险防范建议，否则存在业务故障风险。

请求方式：HTTP GET或HTTPS GET

服务URL：http://203.107.XXX.XXX/{account_id}/resolve（服务IP列表请提工单或加入钉钉群35248489获取）

URL参数说明：

名称	是否必须	描述
host	必须	要解析的域名，多个域名之间以逗号`,`分隔，单次请求最多允许携带5个域名。
ip	可选	用户的来源IP，如果没指定这个参数，默认使用请求连接的源IP。如果指定来源IP，允许指定一个或多个IP，多个IP之间以逗号`,`分隔，单次请求最多允许指定5个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。返回结果其他各字段的含义，请参考单域名解析接口中的描述。