文档中心
服务端 API v2
回调说明
媒体文件合并完成回调

媒体文件合并完成回调

更新时间：2024-08-07 11:50

1 描述

调用合并媒体文件前配置了回调地址且 CDN 厂商为腾讯云时，合并任务完成时会收到该回调，回调将以 POST 的形式对回调地址进行请求。

收到媒体文件合并完成回调后，建议 5s 后再检索相关信息。

2 回调说明

请求方法：POST。
- 回调数据需要 UrlDecode 解码。
- 使用 POST 请求方法传递参数时：
  - Body 中的参数直接传 JsonObject 格式即可，无需序列化为 String 格式。
  - Headers 中，设置 “Content-type” 为 “application/json”。

请求地址：请联系 ZEGO 技术支持配置回调地址。
传输协议：HTTPS/HTTP，建议使用 HTTPS。

3 回调参数

参数	类型	描述
appid	String	AppId。
event	String	回调事件，此回调返回值为 compose。
replay_url	String	合并后的媒体文件的回看地址，不超过 1024 字节。
task_id	String	任务 ID，与合并媒体文件接口响应中 Data 参数内携带的 TaskId 相同。
file_id	String	文件 ID，与检索媒体信息接口响应中 Data 参数内携带的 FileId 相同。
code	String	错误码。0 表示成功，其他值表示失败： 40000：输入参数不合法，请检查输入参数 60000：源文件错误（如视频数据损坏），请确认源文件是否正常 70000：内部服务错误，建议重试
message	String	错误信息。
timestamp	String	服务器当前时间，Unix 时间戳。
nonce	String	随机数。
signature	String	检验串，请参考回调说明 - 检验说明。

4 数据示例

{
    "appid": "1",
    "event": "compose",
    "replay_url": "replay_url",
    "task_id": "task_id",
    "file_id": "5285890813218549789",
    "code": "0",
    "message": "message",
    "timestamp": "1481597358",
    "nonce": "158273",
    "signature": "signature"
}

5 返回响应

返回 HTTP status code 为 2XX （例如 200）表示成功，其他响应都表示失败。

6 回调重试策略

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。