接口说明

该接口用户查询某个用户的分享任务进度

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/douyin/query_user_task/
HTTP Method	POST
Scope	apps.douyin.task
权限要求	需要申请能力。开发者需要至控制台-小程序页面下，进入“能力-能力实验室-小程序能力-拍抖音任务”。开发者类型：企业开发者拍抖音任务能力开发者类型：个人开发者拍抖音任务能力

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Body

app_id必填String

open_id必填String

开启任务的用户openID

该字段通过 /api/apps/v2/jscode2session 接口返回的 openid 字段获取

task_id必填Array<String>

任务 ID 列表

该字段通过 /api/apps/v1/douyin/create_task/ 接口返回的 data.task_id 字段获取

请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/douyin/query_user_task/' \
--header 'access-token: clt.*********' \
--header 'Content-Type: application/json' \
--data-raw '{
    "open_id":"tV2v******",
    "app_id":"tt*******",
    "task_id":["task_*****" , "task_******"]
}'

响应参数

Body展开全部子属性

data必填Struct

任务信息

展开子属性

err_msg必填String

示例：""

错误信息

err_no必填Int32

示例：0

错误码

log_id必填String

示例：202309********************

用于快速定位问题，可在社区反馈时提供

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "log_id": "202309********************",
  "data": {
    "task_info_list": {
      "task_***********": {
        "target_count": 0,
        "task_id": "",
        "video_info": [],
        "completed": false,
        "err_msg": "任务id无效",
        "err_no": 28005074,
        "is_valid": false,
        "success_count": 0
      },
      "task_******************": {
        "is_valid": true,
        "success_count": 1,
        "target_count": 2,
        "task_id": "task_******************",
        "video_info": [
          {
            "video_id": "131041************",
            "video_status": 1
          },
          {
            "video_id": "131041**************",
            "video_status": 2
          }
        ],
        "completed": false,
        "err_msg": "",
        "err_no": 0
      }
    }
  },
  "err_msg": ""
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	28005002	内部错误	内部错误
200	28005001	参数解析失败	参数解析失败
200	28001003	access_token错误	重新获取access_token，见client_token获取说明
200	28005009	openid无效	openid无效
200	28005074	任务id无效	任务id无效
200	28001018	应用未获得该能力	前往控制台开通能力

开发者文档

查询用户任务进度

接口说明

基本信息

请求参数

响应参数

错误码

查询用户任务进度在线调试

接口说明

基本信息

请求参数

响应参数

错误码

查询用户任务进度