解析批量域名

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

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

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

1. API请求格式

警告

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

请求方式:GET

服务URL:http://203.107.XXX.XXX/{account_id}/resolve(服务IP列表请参考获取解析服务地址

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。返回结果其他各字段的含义,请参考解析单个域名中的描述。