You need to enable JavaScript to run this app.
导航

获取热点 URL 统计

最近更新时间2023.12.28 16:29:11

首次发布时间2022.04.28 18:02:34

此接口用于获取热点 URL 统计。

使用说明

  • 点播支持查询 CDN 域名,在某个指定时间区域的热门 URL 排行。
  • 建议使用新的接口获取热点统计数据

请求说明

  • 接口名称:ListCdnTopAccessUrl
  • 接口地址:https://vod.volcengineapi.com?Action=ListCdnTopAccessUrl&Version=2022-01-01

请求参数

参数类型是否必选描述
ActionString接口名称。当前接口取值为 ListCdnTopAccessUrl
VersionString接口版本。当前接口取值为 2022-01-01

SpaceName

String

空间名称。您可通过以下方式获取空间名称:

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。

Domains

String

域名。

注意

当前仅支持设置一个域名。

StartTimestampint32开始时间,相对于 UTC 1970-01-01 到当前时间相隔的秒数。不传默认当天 00:00:00。

EndTimestamp

int32

结束时间,相对于 UTC 1970-01-01 到当前时间相隔的秒数,不传默认当天 23:59:59。限制条件:

  • 单次查询跨度:7 天。
  • 可选时间范围:近 31 天。

SortType

String

排序方式,取值如下:

  • (默认)pv:按请求数(访问量)。
  • flux:按流量。

返回参数

参数类型描述
ResponseMetadataResponseMetadata媒资信息
ResultVodListCdnTopAccessUrl返回结果

ResponseMetadata

参数类型描述
RequestIdString请求 ID
ActionString请求接口
VersionString版本
ServiceString服务
RegionString区域
ErrorResponseError异常信息

ResponseError

参数类型描述
CodeString错误码
MessageString详细错误信息

VodListCdnTopAccessUrl

参数类型描述
UrlsArray of VodCdnTopAccessUrlElement日志列表

VodCdnTopAccessUrlElement

参数类型描述
UrlStringURL
Fluxint64(json 中为 String)流量计数,单位:Byte
Pvint64(json 中为 String)请求次数计数。

示例

请求示例

https://vod.volcengineapi.com?Action=ListCdnTopAccessUrl&Version=2022-01-01&Domains=video01.ethanlei.vip&StartTimestamp=&EndTimestamp=&SpaceName=ethan1

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022041018282501021120913105216644",
        "Action": "ListCdnTopAccessUrl",
        "Version": "2022-01-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "Urls": [
            {
                "Url": "http://video01.ethanlei.vip/abc",
                "Pv": "1",
                "Flux": "100"
            }
        ]
    }
}

错误码

详见视频点播公共错误码

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API,此 API 各语言调用的示例代码,请参考如下: