音视频流审核鉴权 Token

描述

当您使用第三方音视频流审核服务时，您需要通过本接口生成 IdentifyToken 并将其传给审核服务提供商，以作鉴权。

目前支持的厂商包括数美、网易易盾、图谱、依图、火山引擎等厂商，完整对接流程如下：

数美

完成对接数美智能音频流识别、智能视频流识别产品。
调用本服务端接口获取 IdentifyToken。
调用数美音频流上传请求接口或视频流上传请求接口发起请求，在请求参数中需将将 IdentifyToken 赋值给 Token。

网易易盾

完成对接网易易盾的审核功能音视频解决方案。
调用本服务端接口获取 IdentifyToken。
调用网易易盾异步检测接口发起请求，在请求参数中需将将 IdentifyToken 赋值给 Token。

图谱

完成对接图谱的即构语音流异步接口。
调用本服务端接口获取 IdentifyToken。
调用图谱的即构语音流异步接口发起请求，在请求参数中需将将 IdentifyToken 赋值给 Token。

依图和火山引擎

完成对接这两家服务提供商的审核功能，详情请联系服务提供商的技术支持。
调用本服务端接口获取 IdentifyToken。
调用这两家服务提供商的音视频审核接口（详情请联系服务提供商的技术支持）发起请求，在请求参数中需将将 IdentifyToken 赋值给 Token。

注意

每个 IdentifyToken 仅能用于一次审核请求；每次调用接口开始审核前，请重新生成 1 个 IdentifyToken 使用。
不同厂商在实际使用上可能有由于版本更新或其他原因与本文存在差异，建议在使用前联系技术支持确认。

接口原型

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

请求参数

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

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

参数

类型

是否必选

描述

EffectiveTime

Int64

否

流审核鉴权 Token 的有效时长。

单位：秒，默认为 3600 秒；最大不能超过 30 天（即取值不能超过 60 * 60 * 24 * 30）。

请求示例

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

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

响应参数

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

响应示例

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

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

返回码

请参考全局返回码。