查询用户任务进度

开发环境

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

POST

/api/apps/v1/douyin/query_user_task/

该接口用户查询某个用户的拍抖音任务进度
权限要求
需要申请能力。开发者需要至控制台-小程序页面下，进入“能力-能力实验室-小程序能力-拍抖音任务”。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.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_******"]
}'

响应示例

200 - 成功示例

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

请求参数

Header 参数

access-token

string

必需

示例值:

clt.*********

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

open_id

string

必需

开启任务的用户openid

app_id

string

必需

task_id

array[string]

任务id

必需

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

log_id

string

必需

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

data

object

任务信息

必需

task_info_list

object

任务信息映射

必需

err_msg

string

必需

🟠400请求有误

修改于 2023-11-30 04:11:41

创建任务

拍抖音互动任务变更推送