查询小程序任务台任务 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 | 查询时间条件不合法 | 检查请求参数中时间起始值是否合法 |