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"]

返回参数

参数名称
数据类型
参数说明
示例
Referer
String
HTTP referer。
http://www.example.com/
Rank
Float
排名。
1
Request
Float
请求数。
20
Traffic
Float
流量。单位：byte。
15264
Bandwidth
Float
带宽峰值。单位：bps。
176.8266666
QPS
Float
峰值 QPS 。
0.0033334000000000003

请求示例 

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.05.25 16:53:18
这个页面对您有帮助吗？
有用
有用
无用
无用