抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 拍抖音任务
  • 拍抖音互动任务
  • 创建任务
  • 查询用户任务进度
  • 拍抖音互动任务变更推送
  • 分享任务
  • 反馈
  • 客服
  • 小程序券
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 查询用户任务进度

    收藏
    我的收藏

    接口说明

    该接口用户查询某个用户的拍抖音互动任务进度

    • 如果任务无效、视频失败、视频非公开,互动数据将不再更新,返回最后一次有效查询的数据。

    基本信息

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

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Body
    app_idString

    小程序ID

    open_idString

    开启任务的用户openid

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

    task_idList

    任务id

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

    请求示例
    curl --location 'https://open.douyin.com/api/apps/v1/douyin/query_user_interact_task/' \ --header 'access-token: clt.******' \ --header 'Content-Type: application/json' \ --data '{"task_id":["task_7302***07"], "open_id":"yH******7w", "app_id":"ttabc*****" }'

    响应参数

    Body展开全部子属性
    dataStruct

    任务信息

    展开子属性
    err_msgString

    错误信息

    err_noInt32

    错误码

    log_idString

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

    响应示例
    正常响应示例异常响应示例
    { "err_no": 0, "err_msg": "", "log_id": "20231116111433010225127084047533", "data": { "task_info_list": { "task_7301597285245279020": { "task_id": "task_7301597285245279020", "video_info": [ { "video_status": 3, "completed": false, "video_id": "131****087e", "interact_info": { "like": { "completed": false }, "play": { "stage": 0, "completed": false } } }, { "interact_info": { "like": { "completed": false }, "play": { "stage": 0, "completed": false } }, "video_status": 1, "completed": false, "video_id": "1310******20e79" } ], "is_valid": true, "success_count": 0, "max_count": 10, "err_msg": "", "err_no": 0 } } } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028005002

    内部错误

    内部错误

    20028005001

    参数解析失败

    参数解析失败

    20028001003

    accesstoken错误

    accesstoken错误

    20028005009

    openid无效

    openid无效

    20028005074

    任务id列表长度无效

    taskid数量范围是1-10

    20028001018

    应用未获得该能力

    前往控制台开通能力