logo
实时语音
服务端 API
场景服务接口
当前页

DescribeForbidStreamRules

GET

https://rtc-api.zego.im/

查询音视频流封禁规则。

调用频率限制
同一个 AppID 下所有房间:10 次/秒。

说明
如果所查询的 StreamId 不存在、或未设置任何音视频流封禁规则,则返回结果中所有字段值将会为 0,如响应示例中的 streamId2。
注意

调用 DescribeForbidStreamRules 接口,可以查询到当前处于有效期内的规则,也可以查询到已失效的规则。请注意,ZEGO 会不定期清理数据库中的已失效的封禁规则,调用本接口查询得到的失效规则列表可能不完整。

Request

Query Parameters

    Action string必填

    可选值: [DescribeForbidStreamRules]

    接口原型参数

    https://rtc-api.zego.im?Action=DescribeForbidStreamRules

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

    RoomId string必填

    需要查询的房间 ID。

    StreamId string[]必填

    可选值: >= 1, <= 10

    需要查询的流 ID,调用本接口查询时不可超过 10 个流 ID。

Responses

操作成功
Schema
    Code int32

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

    返回码说明处理建议
    0请求成功。-
    1请求失败。请联系 ZEGO 技术支持处理。
    2输入参数错误。-
    9未开通当前接口的使用权限。请联系 ZEGO 技术支持处理。
    123设置流信息失败。请重试,或联系 ZEGO 技术支持处理。
    206App 请求 QPS 过高被限制。降低请求频率,或联系 ZEGO 技术支持提高 QPS 限制阈值。
    Message string

    操作结果描述。

    RequestId string

    请求 ID。

    Data object
    RoomId string

    房间 ID。

    ForbidStreamRuleList object[]
    查询到的音视频流封禁规则信息列表。
  • Array[
  • StreamId string

    查询的流 ID。

    DisableAudio int32

    可选值: [0, 1]

    流 ID 对应的音频是否封禁。0:不封禁;1:封禁。

    DisableVideo int32

    可选值: [0, 1]

    流 ID 对应的视频是否封禁。0:不封禁;1:封禁。

    CreateTime int64

    音视频流封禁规则的创建时间,Unix 时间戳,单位:秒。

    EffectiveTime int64

    音视频流封禁规则的有效时间,Unix 时间戳,单位:秒。

  • ]

ZEGO 签名生成器
Request
折叠所有
Base URL
https://rtc-api.zego.im
统一接入地址(不区分区域)
Parameters
query必填
query必填
query必填
query必填
query必填
query必填
query必填
query必填
RESPONSE清除

点击上方 “发送” 按钮,在此处查看响应。

Previous

设置音视频流封禁规则

Next

删除音视频流封禁规则

当前页

返回到顶部