视频回调
功能介绍
录制视频成功后通知第三方
接口约束
URI
POST 方式请求(接口地址见录制视频接口入参callbackUrl)
请求参数
接口字段 |
字段类型 |
是否必填 |
说明 |
备注 |
|
channelId |
String |
|
频道ID |
|
|
appId |
String |
|
应用ID |
ISDP+申请的appId |
|
recordingId |
String |
|
录制id |
ISDP+生成 |
|
userId |
String |
|
用户ID |
可选,当modeType=0时可用,表示录制当前用户ID的单路视频流 |
|
extraData |
String |
|
回调透传参数 |
支持最大1000位字节 |
|
authTimestamp |
String |
|
事件通知签名过期UNIX时间戳 |
格式为十进制的UNIX时间戳,即从1970年1月1日(UTC/GMT的午夜)以来的当前时间秒数。 示例:1592639100(即2020-06-20 15:45) |
|
fileId |
String |
|
录制文件ID |
当storageType=ISDP时返回 |
|
filePath |
String |
|
录制文件存储路径 |
当storageType=NAS时返回 |
|
fileName |
String |
|
录制文件名 |
文件命名例如:“XXXXXX.mp4” 当storageType=NAS时返回 |
表8.5.4-1请求参数
请求头
字段 |
字段类型 |
是否必填 |
说明 |
备注 |
X-HW-SIGN |
String |
|
请求头参数 |
请求头值(请求参数值拼接的hash256密文):HmacSHA256(appId + appKey + channelId + userId + extraData + authTimestamp) |
表8.5.4-2请求头
响应参数
接口字段 |
字段类型 |
是否必填 |
说明 |
备注 |
errorCode |
int |
|
状态码 |
请参考错误码为空说明成功 |
errorMessage |
String |
|
消息内容 |
SUCCESS,FAIL |
timestamp |
String |
|
时间 |
|
data |
Object |
|
响应内容 |
见data参数 |
表8.5.4-3响应参数
请求示例
请求示例:
{ "channelId": "23198805", "appId": "************************JjLAzFN5", "recordingId": "202212311431169569", "userId": "444444", "extraData": "", "authTimestamp": "2022-02-06T15:47:45.692+0800", "fileId": "", "filePath": "/saas/application/ys.mp4", "fileName": "" }
响应示例:
成功返回示例:
{ "errorCode":"0", "errorMessage": null, "timestamp":"2021-12-15T18:41:14.369+0800", "data": null } 错误示例: { "errorCode":1001001, "errorMessage":"PARAM_IS_INVALID", "timestamp":"2021-12-15T18:41:14.369+0800", "data":null }