TOP 新版数据查询（beta版）

1. 接口描述

接口请求域名： cdn.tencentcloudapi.com 。

DescribeTopData 通过入参 Metric 和 Filter 组合不同，可以查询以下排序数据：

• 依据总流量、总请求数对访问 IP 排序，从大至小返回 TOP 100 IP
• 依据总流量、总请求数对访问 Refer 排序，从大至小返回 TOP 100 Refer
• 依据总流量、总请求数对访问 设备 排序，从大至小返回 设备类型
• 依据总流量、总请求数对访问 操作系统 排序，从大至小返回 操作系统
• 依据总流量、总请求数对访问 浏览器 排序，从大至小返回 浏览器

注意：

• 仅支持 90 天内数据查询，且从2021年09月20日开始有数据
• 本接口为beta版，尚未正式全量发布

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 设备数据返回

查询ua_device指标的数据

输入示例

https://cdn.tencentcloudapi.com/?Action=DescribeTopData
&StartTime=2018-09-04 00:00:00
&EndTime=2018-09-04 12:00:00
&Metric=ua_device
&Filter=request
&Domains.0=www.test.com
&Domains.1=www.test.com
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "37aabaa8-c4c1-45ea-a4aa-8bafea1a496d",
        "Data": [
            {
                "Resource": "all",
                "DetailData": [
                    {
                        "Name": "桌面",
                        "Value": 635,
                        "Percent": 0.6642
                    },
                    {
                        "Name": "其他/未知",
                        "Value": 260,
                        "Percent": 0.272
                    },
                    {
                        "Name": "移动",
                        "Value": 61,
                        "Percent": 0.0638
                    }
                ]
            }
        ]
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。