GenerateIdentifyToken
GET
https://rtc-api.zego.im/
当您使用第三方音视频流审核服务时,您需要通过本接口生成 IdentifyToken
并将其传给审核服务提供商,以作鉴权。
目前支持的厂商包括数美、网易易盾、图谱、依图、火山引擎等厂商,完整对接流程如下:
数美
- 完成对接数美 智能音频流识别、智能视频流识别 产品。
- 调用本服务端接口获取
IdentifyToken
。 - 调用数美 音频流上传请求接口 或 视频流上传请求接口 发起请求,在请求参数中需将将
IdentifyToken
赋值给Token
。
网易易盾
- 完成对接网易易盾 的审核功能 音视频解决方案。
- 调用本服务端接口获取
IdentifyToken
。 - 调用网易易盾 异步检测接口 发起请求,在请求参数中需将将
IdentifyToken
赋值给Token
。
图谱
- 完成对接图谱 的 即构语音流异步接口。
- 调用本服务端接口获取
IdentifyToken
。 - 调用图谱 的 即构语音流异步接口 发起请求,在请求参数中需将将
IdentifyToken
赋值给Token
。
依图和火山引擎
- 完成对接这两家服务提供商的审核功能,详情请联系服务提供商的技术支持。
- 调用本服务端接口获取
IdentifyToken
。 - 调用这两家服务提供商的音视频审核接口(详情请联系服务提供商的技术支持)发起请求,在请求参数中需将将
IdentifyToken
赋值给Token
。
注意
- 每个
IdentifyToken
仅能用于一次审核请求;每次调用接口开始审核前,请重新生成 1 个IdentifyToken
使用。 - 不同厂商在实际使用上可能有由于版本更新或其他原因与本文存在差异,建议在使用前联系技术支持确认。
调用频率限制
同一个 AppID 下所有房间:100 次/秒
Request
Query Parameters
Action stringrequired
Possible values: [GenerateIdentifyToken
]
接口原型参数
https://rtc-api.zego.im?Action=GenerateIdentifyToken
AppId uint32required
💡公共参数。AppId,ZEGO 分配的用户唯一凭证。
SignatureNonce stringrequired
💡公共参数。随机字符串。
Timestamp int64required
💡公共参数。Unix 时间戳,单位为秒。最多允许 10 分钟的误差。
Signature stringrequired
💡公共参数。签名,用于验证请求的合法性。
SignatureVersion stringrequired
Possible values: [2.0
]
Default value: 2.0
💡公共参数。签名版本号。
IsTest string
Possible values: [true
, false
]
Default value: false
💡公共参数。是否为测试环境。设为 true 表示使用测试环境。2021-11-16 及之前在 ZEGO 控制台创建的项目默认是测试环境,可根据业务需求设置此参数;而之后创建的项目默认是正式环境。
EffectiveTime int64
流审核鉴权 Token 的有效时长。
单位:秒,默认为 3600 秒;最大不能超过 30 天(即取值不能超过 60 * 60 * 24 * 30)。
Responses
- 200
成功
- application/json
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
RESPONSEClear