媒资上传和媒体处理等任务都需要一定的时间来完成。为了及时获得任务完成的通知，您可以配置回调订阅。当回调事件完成后，视频点播服务将向您配置的接收地址发送回调信息。您可在回调设置页面管理空间的回调事件、回调鉴权和回调订阅。

HTTP 回调机制

您需要部署一个 HTTP/HTTPS 服务来接收回调消息，并在视频点播控制台中配置回调地址。视频点播的回调机制具体如下：

• 当事件发生时，视频点播服务会向您配置的回调地址发起 POST 请求。
• 您的 HTTP/HTTPS 服务器需返回 200 状态码表示成功，其他状态码表示失败。
• 如果回调失败，视频点播服务会将默认进行 48 小时的重试。重试的时间间隔依次为：1 秒、5 秒、10 秒、30 秒、1 分钟、2 分钟、3 分钟、4 分钟、5 分钟、6 分钟、7 分钟、8 分钟、9 分钟、10 分钟、20 分钟、30 分钟、1 小时。如果仍然未成功，视频点播服务会以 1 小时的频率重试，直至重试累计时长达到 48 小时。

操作步骤

设置回调

1. 登录视频点播控制台，进入指定空间。

2. 单击左侧导航栏系统设置 > 回调设置。

3. 在参数配置页签下，单击修改配置按钮。

4. 根据业务需求，设置回调事件、回调鉴权和鉴权密钥。
   
   详细的参数说明如下表所示。

   序号	参数	说明
   1	回调事件	勾选您需要获取的回调事件。更多信息，请见事件列表。
   2	回调鉴权	默认为关闭。开启后，您需要设置鉴权密钥。更多信息，请见 HTTP 回调鉴权。
   3	鉴权密钥	回调鉴权为已开启时，您需设置鉴权密钥。您可： 自定义鉴权密钥。长度限制为 8-20 个字符，支持大写字母、小写字母和数字。 单击随机生成按钮。系统会自动生成一个鉴权密钥。

5. 单击保存按钮。

添加回调订阅

1. 单击回调订阅区域的添加订阅按钮。
   
2. 在回调订阅配置弹框中，选择请求 Content-Type 和填写您用于接收回调信息的地址。

   说明

   请求 Content-Type 配置将影响点播服务向回调地址发送请求时请求体的数据格式。目前支持以下类型：

   • application/json：JSON 数据格式。
   • application/octet-stream：二进制流数据。
3. 单击确认按钮。

测试回调地址

1. 在回调订阅列表中，单击操作列的测试按钮。
   
2. 在地址测试弹框中勾选待测试事件，单击确定按钮。
3. 在回调记录页签下等待回调完成，刷新界面查看回调测试结果。状态为回调成功，表示接收地址可用。

查看回调记录

1. 单击回调记录页签，根据 Vid、回调状态或回调时间筛选回调记录。

   条件	说明
   Vid	输入音视频 Vid。您可在视频管理页面查看 Vid。
   回调状态	可选择成功、失败或全部回调状态。
   时间	支持查询最近 7 天的回调记录。查询的最小单位为小时。

   说明

   • 最多支持查询 200 条回调记录。
   • 回调记录有延迟。若没有查询到最近的回调记录，请稍后刷新页面查看。

2. 单击回调内容列的详情按钮，查看该回调的详细信息。