You need to enable JavaScript to run this app.
文档中心
全站加速

全站加速

请输入
  • 文档首页
    • 全站加速开发指南API参考数据监控接口 查询Referer排行统计数据 DescribeTopReferers
复制全文
下载 pdf
我的收藏
数据监控接口
查询Referer排行统计数据 DescribeTopReferers
复制全文
下载 pdf
我的收藏
查询Referer排行统计数据 DescribeTopReferers

用于查询指定时间段内，按访问量（如请求数/流量）排序的 Referer 来源排行统计数据，帮助分析访问来源分布。

请求说明

  • 请求方式：POST
  • 请求地址：https://open.volcengineapi.com?Action=DescribeTopReferers&Version=2021-04-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
是
接口名称。当前 API 的名称为 DescribeTopReferers。
Version
String
是
接口版本。当前 API 的版本为 2021-04-01。

Body

参数名称
数据类型
是否必选
参数说明
示例
StartTime
String
是
查询起始时间。
2021-01-01 00:00:00
EndTime
String
是
查询结束时间。
2021-01-01 23:59:59
Sort
String
是

指定排序指标。取值：

  • traffic：流量。
  • bandwidth：峰值带宽。
  • request: 请求数。
  • QPS: 峰值 QPS 。
traffic
Limit
Integer
否
域名获取数量限制，默认为20，取值支持1~100 。
20
ProjectName
String[]
否
指定查询域名所属的项目，为空代表查询当前用户所有项目。
["test"]
Domain
String
否
指定查询域名，不填默认全选。需要指定完整加速域名，不支持域名部分匹配。
test.com
StatusCode
String[]
否
指定查询状态码：2xx、3xx、4xx、5xx。
["2xx"]

返回参数

参数名称
数据类型
参数说明
示例
Result
Array of Object
响应正文最外层为数组，数组中每个元素为一个 Referer 排行统计对象，包含以下子字段。
-

请求示例 

POST https://open.volcengineapi.com?Action=DescribeTopReferers&Version=2021-04-01
{
    "StartTime": "2025-05-01 00:00:00",
    "EndTime": "2025-05-05 00:00:00",
    "Sort": "request",
    "Domain": "dcdn.example.com"
}

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "2025053011505749836738CEDCB1AB3A75",
        "Action": "DescribeTopReferers",
        "Version": "2021-04-01",
        "Service": "DCDN",
        "Region": "cn-north-01"
    },
    "Result": [
        {
            "Bandwidth": 269.3333334,
            "QPS": 0.0066668000000000005,
            "Rank": 1,
            "Referer": "",
            "Request": 34,
            "Traffic": 118184
        },
        {
            "Bandwidth": 176.8533334,
            "QPS": 0.0033334000000000003,
            "Rank": 2,
            "Referer": "http://dcdn.example.com",
            "Request": 12,
            "Traffic": 78402
        },
        {
            "Bandwidth": 159.5733334,
            "QPS": 0.0033334000000000003,
            "Rank": 3,
            "Referer": "http://dcdn.example.com/",
            "Request": 1,
            "Traffic": 5984
        },
        {
            "Bandwidth": 151.92000000000002,
            "QPS": 0.0033334000000000003,
            "Rank": 4,
            "Referer": "http://dcdn.example.com/http-to-https-demo.html",
            "Request": 1,
            "Traffic": 5697
        }
    ]
}

错误码

如果接口调用失败并返回错误信息，您可以查看公共错误码了解错误码相关信息。

最近更新时间：2026.08.19 21:08:59
这个页面对您有帮助吗？
有用
有用
无用
无用