查询用户任务进度
接口说明
该接口用户查询某个用户的拍抖音互动任务进度
- 如果任务无效、视频失败、视频非公开,互动数据将不再更新,返回最后一次有效查询的数据。
基本信息
| 名称 | 描述 |
|---|---|
| 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 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005002 | 内部错误 | 内部错误 |
| 200 | 28005001 | 参数解析失败 | 参数解析失败 |
| 200 | 28001003 | accesstoken错误 | accesstoken错误 |
| 200 | 28005009 | openid无效 | openid无效 |
| 200 | 28005074 | 任务id列表长度无效 | taskid数量范围是1-10 |
| 200 | 28001018 | 应用未获得该能力 | 前往控制台开通能力 |
