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