视频回调
功能介绍
录制视频成功后通知第三方
接口约束
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
}
