视频处理完成后的回调
当处理完毕视频后(上传、转码、审核都完成后),Spark 平台会通过由上传接口入参 notify_url 指定的 HTTP/HTTPS 地址以 GET 方式发起回调。若用户网站地址使用HTTPS协议进行数据安全传输时,用户需保证其拥有的CA证书是合法的。
用户指定的 notify_url 符合以下四种 notify_url 格式之一即为合法:
2、http://domain?data=\*\*\*\*(data为用户自定义的参数)
4、https://domain?data=\*\*\*\*
Spark仅支持带有一个用户自定义参数的notify_url,若参数 notify_url 中携带有用户自定义的参数,则在进行回调通知时会将用户自定义的参数和下表中的参数一起以 THQS 方式进行加密。
参数 | 说明 |
---|---|
videoid | 视频 id,16位 hex 字符串 |
status | 视频状态。”OK”表示视频处理成功,”FAIL”表示视频处理失败,“RECOVER”表示视频被审核团队人工恢复。 |
duration | 片长(单位:秒) |
image | 视频截图地址 |
视频处理失败有多种情况,例如视频文件异常、视频内容违规等等。
<?xml version="1.0" encoding="UTF-8"?><result>OK</result>
当 notify_url 指定的接口返回上述 XML 时,Spark 平台会认为网站已经成功接收到了回调信息,不再进行重试。返回其它任何内容,Spark 平台会进行回调重试,重试的间隔会随着重试次数的增大而增大。若重试 7 次后,依然没有成功,则不再进行通知。因此,Spark 平台最多通知 8 次。这 8 次的通知时间距第一次的通知时间的差分别为:
[0,15s, 1m, 4m, 16m, 1h4m, 4h16m, 17h4m]