开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

查询小程序任务台任务 ID

该接口提供给开发者查询小程序在小程序推广计划中的投稿任务。

使用限制

开发者只能查询当前账号有权限的小程序数据。

接口说明

开发者在小程序推广计划中创建推广任务后,可查询相应小程序的投稿任务数据。

基本信息

HTTP URL

https://developer.toutiao.com/api/apps/taskbox/query_app_task_id

HTTP Method

POST

Scope

权限要求

不需要申请权限 不需要用户授权

请求头

名称

类型

必填

描述

Content-Type

string

固定值 "application/json"

请求参数

Query 请求

Body 请求

名称

类型

是否必填

描述

示例值

access_token


string


权限 token,获取接口

ba253642059040bc9bdf9a1334

appid


string



查询的小程序 appid

abcdefgh123456


create_start_time

number

任务创建起始时间,秒级时间戳

秒级时间戳,例如 1657728000 表示 2022-07-14 00:00:00


create_end_time


number

任务创建终止时间,秒级时间戳

时间参数限制:create_end_time > create_start_time 且 (create_end_time - create_start_time) <= 7 天

秒级时间戳,例如 1658073600 表示

2022-07-18 00:00:00


请求示例

curl --location --request POST 'https://developer.toutiao.com/api/apps/taskbox/query_app_task_id' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "ba253642059040bc9bdf9a1334",
    "appid": "abcdefgh123456",
    "create_start_time": 1657728000,
    "create_end_time": 1658073600
}'

响应参数

名称

类型

描述

示例值

error


number

错误码,0 是成功,其它为异常

0

message

string


成功为"success", 错误为具体 message

success

data

array

任务ID数组,数组元素类型为 number


[ 1130941336206704680, 1130954062622638121]

响应示例

正常示例

{
  "data": [1130941336206704680, 1130954062622638121, 1130965975075143722],
  "error": 0,
  "message": "success"
}

异常示例

{
  "message": "查询时间条件不合法",
  "error": 5510,
  "data": []
}

错误码

HTTP 状态码

错误码

描述

排查建议

200

5422

请求超时或系统异常,请重试

重新发起请求,尝试重试

200

5501

access_token 参数错误

检查 access_token 字段是否为空且合法

200

5502

access_token 不合法

检查 access_token 字段是否为空且合法

200

5503

access_token 无权限

检查 access_token 对应的 app_id 是否有相应权限

200

5509

无 app_id 查询权限

检查 access_token 对应的 app_id 是否有相应权限

200

5510

查询时间条件不合法

检查请求参数中时间起始值是否合法

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助