回调设置
最近更新时间：2022.12.28 20:59:28
首次发布时间：2021.02.23 10:42:41
回调设置支持管理空间的回调事件、回调鉴权和回调订阅。执行媒资上传和工作流任务等事件都需要一定的时间，为了保证可以在任务完成后第一时间得到通知，您可以配置回调订阅。回调事件完成后，视频点播服务会向配置的接收地址发送回调信息。点播支持的回调事件包括：
- URL 批量拉取上传完成
- 媒资上传完成
- 素材上传完成
- 工作流执行完成
- 媒资删除完成
- 媒体文件删除完成
- 视频剪辑完成
- 媒资上传抽取元信息完成
- 修改媒资存储类型完成
背景信息
点播的回调机制如下所示：
- 当事件完成时，点播服务端会向该 URL 发起 POST 请求。
- 您的 HTTP/HTTPS 服务器需回复 200 状态码表示成功，其他状态码为失败。
- 回调失败后，点播会默认重试 48 小时，重试的时间间隔依次为：1s、5s、10s、30s、1m、2m、3m、4m、5m、6m、7m、8m、9m、10m、20m、30m、1h。
前提条件
查看回调记录前，请先完成回调事件、回调鉴权和回调订阅的设置。
操作步骤
设置回调
- 选择左侧导航栏系统设置>回调设置，进入回调设置页面。
- 选择参数配置页签，单击修改配置按钮，支持设置回调事件、回调鉴权和鉴权密钥。
详细的参数配置如下表所示。
| 序号 | 参数 | 说明 |
|---|---|---|
| 1 | 回调事件 | 支持勾选获取回调信息的事件。 |
| 2 | 回调鉴权 | 开关按钮，默认为已关闭状态。 |
3 | 鉴权密钥 | 回调鉴权为已开启状态时，显示鉴权密钥。支持的操作有：
|
- 单击保存配置按钮，完成设置。
添加回调订阅
- 选择左侧导航栏系统设置>回调设置，选择参数配置页签，单击回调订阅区域框下的添加订阅按钮。
- 在回调订阅配置弹框中选择请求 Content-Type 和填写希望接收回调信息的地址，单击确认按钮，保存配置。
说明
该配置将影响点播服务向回调地址发送请求时请求体的数据格式，目前支持 2种内容类型的选择。
- application/json：JSON 数据格式；
- application/octet-stream：二进制流数据。
- 添加完成后，在回调订阅列表的操作列支持测试、编辑和删除订阅。
测试回调地址
- 在回调订阅列表中，单击操作列的测试按钮。
- 在地址测试对话框中选择测试事件，单击确定按钮，发送测试消息。
- 选择回调记录页签，等待回调完成，刷新界面查看回调测试结果，状态为回调成功，表示接收地址可用。
查看回调记录
- 进入系统设置>回调设置>回调记录，支持根据过滤 Vid、回调状态、回调时间进行回调记录查询。
| 条件 | 说明 |
|---|---|
| Vid | 输入音视频 Vid，Vid 信息可以在视频详情页查看。 |
| 回调状态 | 可选择成功、失败或全部回调状态。 |
| 时间 | 支持查询最近 7 天的回调记录，查询的最小单位为小时。 |
说明
回调记录有延迟，若没有查询到最近的回调记录，请稍后刷新页面进行查看。
- 单击回调内容列的详情按钮，可以查看该回调的详细信息。
