← 返回目录
📁 API Reference › Creative Tools

(已废弃)任务回调说明

当模板视频任务完成后,如果创建任务时(如使用接口/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)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →