查询用户任务进度
接口说明
该接口用户查询某个用户的分享任务进度
基本信息
| 名称 | 描述 |
|---|---|
| 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
content-type必填String
固定值"application/json"
Body
app_idString
open_idString
开启任务的用户openID
该字段通过 /api/apps/v2/jscode2session 接口返回的 openid 字段获取
task_idArray<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展开全部子属性
dataStruct
任务信息
展开子属性
err_msgString
错误信息
err_noInt32
错误码
log_idString
用于快速定位问题,可在社区反馈时提供
响应示例
正常响应示例异常响应示例
{ "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 | 应用未获得该能力 | 前往控制台开通能力 |
