查询小程序任务台任务 ID-v2
收藏接口说明
该接口提供给开发者查询小程序在小程序推广计划中的投稿任务。
使用限制
开发者只能查询当前账号有权限的小程序数据。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/match/v2/taskbox/query_app_task_id/ |
| HTTP Method | POST |
| Scope | match_taskbox.default.plan_permission |
| 权限要求 | 服务商代调用场景下，需商家授予小程序推广计划-任务管理权限。 任务台 |
请求参数
请求头
access-token必填String
当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
create_end_time必填Int64
示例：1658073600
- 任务创建终止时间，秒级时间戳
- 时间参数限制：create_end_time > create_start_time 且 (create_end_time - create_start_time) <= 7 天
create_start_time必填Int64
示例：1657728000
任务创建起始时间，秒级时间戳
task_categoryEnum
示例：1
任务类别枚举，1=短视频任务，2=直播任务。
如果没有填入，则默认是1，查询短视频任务。
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/taskbox/query_app_task_id/' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{ "create_start_time": 1657728000, "create_end_time": 1658073600 }'
响应参数
Body展开全部子属性
err_msg必填String
示例：success
错误信息
err_no必填Int32
示例：0
错误码，0 是成功，其它为异常
log_id必填String
示例：202008121419360101980821035705926A
标识请求的唯一id，在接口异常时用于问题排查
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "success", "log_id": "202008121419360101980821035705926A", "data": { "task_ids": [ 1130941336206704600, 1130954062622638100, 1130965975075143700 ] } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 5422 | 请求超时或系统异常，请重试 | 重新发起请求，尝试重试 |
| 200 | 5510 | 查询时间条件不合法 | 检查请求参数中时间起始值是否合法 |
| 200 | 5515 | 调用者无权限 | 请服务商前往「服务商平台-能力-代商家管理能力-小程序推广计划」完成协议签署 |
| 200 | 5516 | 调用者无权限 | 请服务商前往「服务商平台-设置-权限设置」申请该小程序的「小程序推广计划-任务管理」权限 |
| 200 | 5517 | 该小程序暂未完成撮合平台协议的签署 | 请开发者前往「开发者平台-运营-小程序推广计划」完成协议签署 |
| 200 | 28001018 | 应用未获得该能力 | 请服务商前往「服务商平台-设置-权限设置」申请该小程序的「小程序推广计划-任务管理」权限 |
