查询用户任务进度

开发环境

http://dev-cn.your-api-server.com

POST

/api/apps/v1/douyin/query_user_interact_task/

如果任务无效、视频失败、视频非公开，互动数据将不再更新，返回最后一次有效查询的数据。
权限要求
需要申请能力。开发者需要至控制台-小程序页面下，进入“能力-能力实验室-小程序能力-拍抖音任务”。

错误码

HTTP 状态码	错误码	描述	排查建议
200	28005002	内部错误	内部错误
200	28005001	参数解析失败	参数解析失败
200	28001003	accesstoken错误	accesstoken错误
200	28005009	openid无效	openid无效
200	28005074	任务id无效	任务id无效
200	28001018	应用未获得该能力	前往控制台开通能力
200	28005074	taskid超出限制长度	taskid最多传递10个

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/v1/douyin/query_user_interact_task/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{"task_id":["task_7302***07"],
"open_id":"yH******7w",
"app_id":"ttabc*****"
}'

响应示例

200 - 成功示例

{
    "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
            }
        }
    }
}

修改于 2025-11-10 08:43:42

创建任务

查询用户任务进度

错误码#

请求参数

返回响应

错误码