API 说明 #

基于火山引擎内容分发网络（CDN）的向源站发送的回源请求，该 API 对一个域名统计热门的回源 URL。

要调用该 API，您需要指定一个指标和一个统计时间段。您最多能查询过去 92 天的数据。

数据稳定性：受网络波动影响，边缘节点上统计的指标数据可能会发生变化。大多数情况下，指标数据会在 12 小时内逐步稳定下来。

数据时效性：热门的回源 URL 是基于按小时粒度统计的指标数据。因此，数据统计可能会有 2 小时左右的延时。例如，对于 09:00 至 10:00 这个时间段的热门的回源 URL，您可以在 11:00 左右获取到准确的结果。

使用限制 #

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明 #

• 请求方式：POST
• 请求地址：https://cdn.volcengineapi.com/?Action=DescribeOriginTopStatisticalData&Version=2021-03-01

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

POST https://cdn.volcengineapi.com/?Action=DescribeOriginTopStatisticalData&Version=2021-03-01
{
    "Domain": "www.example.com",
    "StartTime": 1702742400,
    "EndTime": 1702742400,
    "Item": "url",
    "Metric": "flux"
}

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20231218104008F1E2EB3BEFFEE70DFDE9",
        "Action": "DescribeOriginTopStatisticalData",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    },
    "Result": {
        "Item": "url",
        "Metric": "flux",
        "Domain": "www.example.com",
        "TopDataDetails": [
            {
                "ItemKey": "https://www.example.com/images/chickadee.png",
                "Value": 11098443381
            },
            {
                "ItemKey": "https://www.example.com/images/hornbill.png",
                "Value": 4545790702
            }
        ]
    }
}

错误码 #

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。