查询域名解析地域分布
更新时间：2019-08-27 11:09:04
适用产品
云解析CloudDNS
接口描述
获取域名解析地域分布报表数据(仅限近3个月的数据)
- 调用URL： https://open.chinanetcenter.com/clouddns/DomainRequestMap
- 调用方法：POST
请求参数
Body 参数
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
domain | List | 是 | 包含两个子参数：domainName、dcName |
┗domainName | String | 是 | domain的子参数，是指域名名称 |
┗dcName | String | 否 | domain的子参数，指主机记录（如果dcName为空，则返回请求总数） 【备注：如果查询某个域名的总请求数，需在dcName输入所有主机头，请务必别忘了“@“主机头”】 |
timeType | String | 是 | 时间粒度： 1day 10分钟粒度（仅支持最近1天的数据，数据可能延迟1小时左右） 7day 小时粒度（仅支持最近7天的数据查询） month 天粒度（仅支持最近1个月的数据查询） q 天粒度（仅支持最近3个月的数据查询） custom 自定义查询日期（近3个月以内） |
mapType | Int | 是 | 地图类型： 0:中国地图 1:大洲统计地图 2:各个国家统计 |
startTime | string | 否 | 当timeType为custom时必填，自定义开始日期，格式"yyyy-MM-dd" |
endTime | string | 否 | 当timeType为custom时必填，自定义结束日期，格式"yyyy-MM-dd" |
isp | Int | 否 | mapType为0时选项，非必填 运营商类型： 0 总解析量 1 电信 2 联通 3 移动 4 其他运营商 |
language | string | 否 | 为空返回中文结果(默认) en:返回英文提示结果 |
返回参数
Body 参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
resCode | Int | 状态码。resCode的详细说明请参见“附录1业务状态码”。 |
msg | String | 状态码的详细说明 |
area | String | 区域（省份或者大洲） |
value | Int | 请求数 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| 100 | 服务器端错误 | 200 | |
| 101 | 参数不能为空 | 200 | |
| 102 | 接口请求参数错误 | 200 | |
| 202 | 域名不存在 | 200 |
示例
JSON
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://open.chinanetcenter.com/clouddns/DomainRequestMap" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{ "domain": [ { "domainName":"yhclub.top", "dcName":"www" }, { "domainName":"yhclub.top", "dcName":"abc" } ], "timeType":"q", "mapType":0, "isp":0 }'- 返回示例 复制成功
{ "resCode":0, "msg":"操作成功", "content":[ { "area":"北京", "value":37 }, { "area":"重庆", "value":2 }, { "area":"福建", "value":33 }, { "area":"广东", "value":66 }, { "area":"河南", "value":2 }, { "area":"江苏", "value":27 } ] }
本篇文档内容对您是否有帮助？
有帮助
我要反馈