音视频流审核鉴权 Token

更新时间：2025-04-15 17:17

1 描述

本接口用于客户直接对接数美时，获取请求智能音频流识别、智能视频流识别的身份验证信息 Token。

通过本接口的实现步骤如下：

完成和数美 智能音频流识别、智能视频流识别产品的对接。
调用 ZEGO 的本服务端接口获取 IdentifyToken。
调用数美提供的音频流上传请求接口、视频流上传请求接口，将步骤 2 中获取到的 IdentifyToken 作为请求参数中的 Token，发起请求。

每个 IdentifyToken 仅能用于一次审核请求；每次调用接口开始审核前，请重新生成 1 个 IdentifyToken 使用。

2 接口原型

请求方法：GET
请求地址：https://rtc-api.zego.im/?Action=GenerateIdentifyToken
传输协议：HTTPS
调用频率限制（同一个 AppID 下所有房间）：100 次/秒

3 请求参数

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

参数	类型	是否必选	描述
EffectiveTime	Int64	否	流审核鉴权 Token 的有效时长。单位：秒，默认为 3600 秒；最大不能超过 30 天（即取值不能超过 606024*30）。

4 请求示例

https://rtc-api.zego.im/?Action=GenerateIdentifyToken
&AppId=1234567890
&SignatureNonce=15215528852396
&Timestamp=1234567890
&Signature=7a2c0f11145fb760d607a07b54825013
&SignatureVersion=2.0
&EffectiveTime=3600

5 响应参数

参数	类型	描述
Code	Int32	返回码。
Message	String	操作结果描述。
RequestId	String	请求 ID。
Data	Object	响应数据。
IdentifyToken	String	鉴权 Token。
RemainTime	Int64	Token 的有效时长，指在“有效时长”范围内，可以向 `数美` 发起音视频流审核；审核任务开始后，正常流审核期间，不会出现审核用户掉线的问题。单位：秒，默认为 1 小时（3600 秒）。

6 响应示例

{
    "Code":0,
    "Data":{
        "IdentifyToken":"1234567890asdfasdfzxcvxxxxxxxxxx",
        "RemainTime":3600
    },
    "Message":"success",
    "RequestId":"TestRequestId1653536127853122000"
}

7 返回码

请参考全局返回码。