获取推流质量数据
该方法获取指定流在指定时间范围内的推流质量数据。
推流质量数据有约 3 分钟的延时,支持查询 6 天内的推流记录,单次查询范围不能超过 6 小时。
请求
API Key
融合 CDN 直播 RESTful API 使用 HTTP HMAC (Hash-based Message Authentication Code) 认证。
在发送 HTTP 请求时,你需要通过 HMAC-SHA256 算法生成一个签名,并在请求头部的 Authorization
字段传入签名及相关信息。详见认证方式。
路径参数
声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。
发布点名称。
查询参数
查询推流质量数据的开始时间,格式为 RFC3339 时间格式对应的 URL 编码,例如 2019-01-07T12:00:00+08:00
对应 2019-01-07T12%3A00%3A00%2B08%3A00
。开始时间不能早于当前时间 6 天前的时间。如果 start_time
和 end_time
都不填,默认查询最近 6 小时的推流质量数据。
查询推流质量数据的结束时间,格式为 RFC3339 时间格式对应的 URL 编码,例如 2019-01-07T12:00:00+08:00
对应 2019-01-07T12%3A00%3A00%2B08%3A00
。结束时间不能晚于当前时间。如果 start_time
和 end_time
都不填,默认查询最近 6 小时的推流质量数据。
要查询推流质量的直播流名称。
响应
如果返回的 HTTP 状态码为 200,表示请求成功。
响应 Body
推流质量数据列表,按照推流质量数据时间从晚到早排序。一条推流记录对应一个 JSON Object。
流的名称。
推流质量数据的时间。RFC3339 格式,例如 "2019-01-07T12:00:00+08:00"
。
推流码率,单位为 bps。
推流帧率,单位为 fps。
推流 CDN 节点的 IP 地址。
推流客户端的 IP 地址。
请求示例
curl --request get \
--url 'https://api.sd-rtn.com/v1/projects/:appid/fls/entry_points/:entry_point/reports/publish_quality?stream_name=' \
--header 'Authorization: Basic <credentials>'
响应示例
{
"QualityHistory": [
{
"name": "{your_stream_name}",
"time": "2021-08-25T12:19:00+08:00",
"bitrate": 1123388,
"framerate": 31,
"cdnIp": "58.220.74.80",
"clientIp": "218.19.252.82"
},
{
"name": "{your_stream_name}",
"time": "2021-08-25T12:18:00+08:00",
"bitrate": 1177908,
"framerate": 30,
"cdnIp": "58.220.74.80",
"clientIp": "218.19.252.82"
}
]
}