RTC 流状态查询

描述

本接口支持查询指定流的实时状态（是否活跃或存在）。只支持查询推流到 ZEGO 媒体服务器（RTC 服务）的流，不支持查询直接推流到 CDN 或者混流服务输出的流。

推荐优先使用 流创建回调 和 流关闭回调 异步获取当前推流信息。本接口一般作为流创建回调和流关闭回调的辅助接口，或者在业务后台查询指定单流是否活跃时使用。

接口原型

• 请求方法：GET
• 请求地址：https://rtc-api.zego.im/?Action=DescribeRTCStreamState
• 传输协议：HTTPS
• 调用频率限制：40 次/秒（测试环境：10 次/秒）

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 完整公共参数列表请参考 调用方式 中的 “公共请求参数”。

请求示例

https://rtc-api.zego.im/?Action=DescribeRTCStreamState
&StreamId=rtc01
&Sequence=1617249600001
&<公共请求参数>

https://rtc-api.zego.im/?Action=DescribeRTCStreamState
&StreamId=rtc01
&Sequence=1617249600001
&<公共请求参数>

响应参数

响应示例

{
    "Code": 0,
    "Message": "ok",
    "RequestId": "98004",
    "Data": {
        "create_time": "1673334117",
        "close_time": ""
    }
}

{
    "Code": 0,
    "Message": "ok",
    "RequestId": "98004",
    "Data": {
        "create_time": "1673334117",
        "close_time": ""
    }
}

返回码

以下仅列出了接口业务逻辑相关的部分返回码，完整返回码请参考 全局返回码。