接口功能介绍
本接口用于查询直播在线拉流数据。
接口详情
请求方式：post
请求路径：/live/statistics/query-pull-stream-info
使用说明
- 单个用户一分钟限制调用10000次，并发不超过100；
- 可查询历史数据时间范围为最近14天；
- 单次可查询的时间跨度为1小时；
- 数据延迟时间为2min。
请求参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| domain | 是 | list | 加速域名列表，单次查询输入域名的个数不能超过10个 | [“ctyun.cn”,“ctyun.cn1”] | |
| appname | 否 | list | 发布点列表 | [“app_1”,“app_2”] | |
| streamname | 否 | list | 流名列表 | [“stream_1”,“stream_2”] | |
| start_time | 是 | int | 开始时间戳,单位秒 | 1655108160 | |
| end_time | 是 | int | 结束时间戳,单位秒 | 1655111760 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | int | 状态码 | 100000 | |
| message | 是 | string | 描述信息 | success | |
| result | 否 | list | 返回结果列表 | result_single |
表result_single：
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| time | 否 | int | 最新时间戳，单位秒 | ||
| peerIsp | 否 | string | 运营商 | 中国电信 | |
| peerIp | 否 | string | 拉流ip | 101.201.252.162 | |
| stream | 否 | string | 流名 | stream_1 | |
| appName | 否 | string | 发布点 | app_1 | |
| peerProvince | 否 | string | 拉流ip归属地（省） | 内蒙古自治区 | |
| peerCity | 否 | string | 拉流ip归属地（市） | 呼和浩特市 | |
| channel | 否 | string | 域名 | ctyun.cn2 | |
| pullStartTime | 否 | int | 推流开始时间戳，单位秒 | 1631541676 | |
| pullEndTime | 否 | int | 推流结束时间戳，单位秒 | 1631541736 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/statistics/query-pull-stream-info
请求示例
{
"domain": [
"ctyun.cn"
],
"start_time": 1631541917,
"end_time": 1631543317
}
正常响应示例
{
"code": 100000,
"message": "success",
"result": [
{
"peerIsp": "其他",
"peerIp": "1.1.1.1",
"stream": "stream_1",
"peerCity": "北京市",
"appName": "app_1",
"peerProvince": "北京市",
"channel": "ctyun.cn",
"pullStartTime": 1631541826,
"time": 1631542046,
"pullEndTime": 0
},
{
"peerIsp": "其他",
"peerIp": "2.2.2.2",
"stream": "stream_2",
"peerCity": "北京市",
"appName": "app_2",
"peerProvince": "北京市",
"channel": "ctyun.cn",
"pullStartTime": 1631541676,
"time": 1631542026,
"pullEndTime": 0
}
]
}
