(已废弃)任务回调说明
当模板视频任务完成后,如果创建任务时(如使用接口/quick_optimization/create/)指定了callback_url,任务完成后服务端会通过该URL发起HTTP POST请求,extra_callback_info将与任务结果信息一起返回。
如果服务器已成功处理了请求,请在5秒内返回状态码200。否则服务器将重新发送请求,请求上线为2次。请确保网址是空的,因为有可能重试。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|请求参数名称|err_msg|error_msg`|
# 请求
**地址**
创建视频任务时传入的`callback_url`
**方法**
POST
**Header**
```xtable
|字段|类型|描述|
|--- |--- |--- |
|Content-Type{必填}|string|请求消息类型,允许值:`application/json`|
参数
|字段|类型|描述|
|-|-|-|
|task_id |string|任务ID。|
|status |string|任务状态。枚举值详见:[枚举值 - 任务状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
|video_ids{+ 条件返回} |string[]|视频ID列表。仅当 status 为 "SUCCESS" 时有效。|
|error_msg{+ 条件返回} |string|错误信息 |
|extra_info{+ 条件返回} |object |创建任务时指定的 callback_extra_info |
示例
(code Sample Parameters)
{
"status": "SUCCESS",
"video_ids": [
"v09033a60000bt1posj6hujpgbgomlo2",
"v090336c0000bt1pp2ac3teiuedco26s"
],
"extra_info": {
"name": "test"
}
}
(/code)