最近更新时间:2024.01.08 17:26:45
首次发布时间:2023.07.28 17:07:19
点播支持查询 CDN 域名,在某个指定时间区域的热门数据排行。此接口用于获取热点数据统计。
请求地址:https://vod.volcengineapi.com?Action=ListCdnTopAccess&Version=2023-07-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListCdnTopAccess | 接口名称。当前 API 的名称为 ListCdnTopAccess 。 |
Version | String | 是 | 2023-07-01 | 接口版本。当前 API 的版本为 2023-07-01 。 |
Domains | String | 是 |
| 域名。您可通过 ListDomain 接口获取指定空间下的域名列表。 注意 当前仅支持一个域名。 |
StartTimestamp | Integer | 否 | 1689667200 | 开始时间,相对于 UTC 1970-01-01 到当前时间相隔的秒数。不传默认当天 00:00:00。 |
EndTimestamp | Integer | 否 | 1689824898 | 结束时间,相对于 UTC 1970-01-01 到当前时间相隔的秒数,不传默认当天 23:59:59。 |
SortType | String | 否 |
| 统计方式。取值如下:
|
Item | String | 否 |
| 指定一个统计字段。取值如下:
|
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ItemInfos | Array of ItemInfos | - | 热点统计数据列表信息。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ItemKey | String |
| 根据 Item 所得对应的 key。 |
Value | Double | 59 | 根据统计字段和统计方式得到的对应值。 |
https://vod.volcengineapi.com?Action=ListCdnTopAccess&Version=2023-07-01
{ "ResponseMetadata": { "RequestId": "202306041104****100232280022D31", "Action": "ListCdnTopAccess", "Version": "2023-07-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "ItemInfos": [ { "ItemKey": "www.example.vod.com", "Value": 59 } ] } }
本接口无特有的错误码。更多信息请见公共错误码。
点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API。此 API 各语言调用的示例代码,请参考如下: