CDN加速

文档中心 API文档 查询域名的TOP访客对应的TOPURL

查询域名的TOP访客对应的TOPURL

更新时间:2021-12-14 11:15:42

适用产品

网页加速、下载分发、动态加速、全站加速、点播分发、直播分发、上传加速、移动加速、S-P2P、PCDN、应用性能管理、Web应用防火墙、BotGuard爬虫管理、WSS、DMS、DDoS云清洗、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案、应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案

接口描述

查询top20访客IP对应的Top10URL。

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Body 参数

参数名称类型必填描述
domain
List域名: 1. 可传递域名数量上限默认为20个(可联系技术支持调整); 2. 自动过滤掉非法域名(如传递非法域名,会被过滤掉,查询结果只返回合法域名的数据)。
dateFrom
String开始时间: 1.格式为yyyy-MM-ddTHH:mm:ss+08:00,例如,2016-12-02T10:00:00+08:00(为北京时间2016年12月2日10点0分0秒); 2.不能大于当前时间; 3.最多可获取最近半年(183天)的数据。
dateTo
String结束时间: 1.时间格式2016-12-02T10:00:00+08:00 2.结束时间需大于开始时间。 3.结束时间如果大于当前时间,取当前时间。 4.允许最大查询跨度为7天.
dataInterval
String数据粒度: 1. 支持1d(天) 2. 不传默认1d。
orderBy
String统计参照: 1、支持按照请求数request取top; 2、支持按照流量flow取top。 3、默认按照request排行。

返回参数

Body 参数

参数名称类型描述
result
List-
domain
String域名
details
List-
timestamp
String时间片: 1、查询的数据粒度为1d时,格式为yyyy-MM-dd;每一个时间片数据值代表的该天内的数据值。 2、返回开始时间和结束时间包含的时间片。
ipData
List-
ip
Stringip地址,国内的IP地址。
urlData
Listurl

错误码

错误代码(code)描述(message)HTTP状态码语义
NotAcceptableThe accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json和xml格式,默认为json格式
MissingBodyThis   operation requires a body. Ensure that the body is present and the   Content-Type header is set.400请求体没有传递
InvalidHTTPRequestThere was an error in the body of your HTTP request.400请求体格式错误
InvalidDatePeriodThe date specified is invalid.400dateFrom或dateTo不符合规范
DateSpanErrorYou cannot specify a period greater than 7 day(s).400dateFrom和dateTo相差超过7天
NumberLimitExceededThe request was rejected because the number of domain({actual}) exceeds the limit({expect}).400查询的域名个数超出限制
PARAM_INVALIDparam: domain is null or invalid.400参数domain不符合规范
PARAM_INVALIDparam: orderBy is null or invalid.400参数orderBy不符合规范
PARAM_INVALIDparam: dataInterval is null or invalid.400参数dataInterval不符合规范

示例

JSON
XML
JSON
请求示例
复制代码 复制成功
#!/bin/bash
# 请将示例中的(-H "X-Time-Zone") 参数设置为您希望在返回结果中获得的时区
# Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response

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/api/report/url-top/visitor" \
-X "POST" \
-H "X-Time-Zone:GMT+08:00" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"dateFrom": "2018-09-08T10:00:00+08:00",
 "dateTo": "2018-09-10T10:00:00+08:00",
 "domain": [
 "test1.com",
 "test2.com"
 ],"dataInterval": "1d",
 "orderBy": "request"
}'
返回示例
复制代码 复制成功
{
    "result": [
        {
            "domain": "www.test.com",
            "details": [
                {
                    "timestamp": "2018-09-08",
                    "ipData": [
                        {
                            "ip": "1.1.1.23",
                            "urlData": [
                                "www.test.com/13",
                                "www.test.com/12",
                                "www.test.com/11",
                                "www.test.com/10",
                                "www.test.com/9",
                                "www.test.com/8",
                                "www.test.com/7",
                                "www.test.com/6",
                                "www.test.com/5",
                                "www.test.com/4"
                            ]
                        },
                        {
                            "ip": "1.1.1.22",
                            "urlData": [
                                "www.test.com/13",
                                "www.test.com/12",
                                "www.test.com/11",
                                "www.test.com/10",
                                "www.test.com/9",
                                "www.test.com/8",
                                "www.test.com/7",
                                "www.test.com/6",
                                "www.test.com/5",
                                "www.test.com/4"
                            ]
                        }
                },
                {
                    "timestamp": "2018-09-09",
                    "ipData": [
                        {
                            "ip": "1.1.1.23",
                            "urlData": [
                                "www.test.com/13",
                                "www.test.com/12",
                                "www.test.com/11",
                                "www.test.com/10",
                                "www.test.com/9",
                                "www.test.com/8",
                                "www.test.com/7",
                                "www.test.com/6",
                                "www.test.com/5",
                                "www.test.com/4"
                            ]
                        },
                        {
                            "ip": "1.1.1.22",
                            "urlData": [
                                "www.test.com/13",
                                "www.test.com/12",
                                "www.test.com/11",
                                "www.test.com/10",
                                "www.test.com/9",
                                "www.test.com/8",
                                "www.test.com/7",
                                "www.test.com/6",
                                "www.test.com/5",
                                "www.test.com/4"
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!