查询小程序任务台任务 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
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_category	Enum	否	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，在接口异常时用于问题排查
data	Struct	否

响应示例

正常响应示例

{
  "err_no": 0,
  "err_msg": "success",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "task_ids": [
      1130941336206704600,
      1130954062622638100,
      1130965975075143700
    ]
  }
}

异常响应示例

{
  "err_no": 5510,
  "err_msg": "查询时间条件不合法",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "task_ids": []
  }
}

错误码

http状态码	错误码	错误码描述	排查建议
200	5422	请求超时或系统异常，请重试	重新发起请求，尝试重试
200	5510	查询时间条件不合法	检查请求参数中时间起始值是否合法
200	5515	调用者无权限	请服务商前往「服务商平台-能力-代商家管理能力-小程序推广计划」完成协议签署
200	5516	调用者无权限	请服务商前往「服务商平台-设置-权限设置」申请该小程序的「小程序推广计划-任务管理」权限
200	5517	该小程序暂未完成撮合平台协议的签署	请开发者前往「开发者平台-运营-小程序推广计划」完成协议签署
200	28001018	应用未获得该能力	请服务商前往「服务商平台-设置-权限设置」申请该小程序的「小程序推广计划-任务管理」权限

查询小程序任务台任务 ID-v2在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

查询小程序任务台任务 ID-v2