查询所有任务

GET

/task/v1/tasks

以分页的方式获取任务列表。当使用user_access_token时，获取与该用户身份相关的所有任务。当使用tenant_access_token时，获取以该应用身份通过“创建任务“接口创建的所有任务（并非获取该应用所在租户下所有用户创建的任务）。本接口支持通过任务创建时间以及任务的完成状态对任务进行过滤。

错误码

HTTP状态码	错误码	描述	排查建议
403	1470403	The identity token is incorrect. It should be either user_access_token or tenant_access_token.	发起请求方的身份token不正确，需要为UserAccessToken或TenantAccessToken其中一种
500	1470605	failed to get task list	一般是系统内部错误造成的，可联系维护同学进行处理
400	1470421	page_size exceed 100	分页大小超过最大值100，需要减小page_size的值
400	1470422	failed to parse page_token	解析分页标识失败，需要检查分页标识是否合法

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/task/v1/tasks?page_size=10&page_token=MTYzMTg3ODUxNQ==&user_id_type=open_id&start_create_time=1652323335&end_create_time=false&task_completed=' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "data": {
        "has_more": true,
        "items": [
            {
                "can_edit": true,
                "collaborators": [
                    {
                        "id": "ou_842f5b9b4b8faa60570e9008acc9af1f"
                    }
                ],
                "complete_time": "1637119864",
                "create_time": "1637045612",
                "creator_id": "ou_5df8b925054285f7166bf8b6ff03341f",
                "custom": "",
                "description": "多吃水果，多运动，健康生活，快乐工作。",
                "due": {
                    "time": "1637137860",
                    "timezone": "Asia/Shanghai"
                },
                "extra": "dGVzdA==",
                "followers": [
                    {
                        "id": "ou_842f5b9b4b8faa60570e9008acc9af1f"
                    }
                ],
                "id": "11d42f77-cfa4-4833-a76e-ad778b081077",
                "origin": {
                    "href": {
                        "title": "反馈一个问题，需要协助排查",
                        "url": "https://support.feishu.com/internal/foo-bar"
                    },
                    "platform_i18n_name": "{\"en_us\":\"IT Workspace\",\"zh_cn\":\"IT 工作台\"}"
                },
                "source": 6,
                "summary": "少喝咖啡",
                "update_time": "1637119866"
            },
            {
                "collaborators": [
                    {
                        "id": "ou_842f5b9b4b8faa60570e9008acc9af1f"
                    }
                ],
                "complete_time": "1636965009",
                "create_time": "1632886899",
                "creator_id": "ou_5df8b925054285f7166bf8b6ff03341f",
                "custom": "",
                "description": "",
                "due": {
                    "time": "0",
                    "timezone": ""
                },
                "extra": "",
                "followers": [
                    {
                        "id": "ou_842f5b9b4b8faa60570e9008acc9af1f"
                    }
                ],
                "id": "692ec13b-613d-4d0b-818d-a34ae2cb1413",
                "origin": {
                    "href": {},
                    "platform_i18n_name": "null"
                },
                "source": 1,
                "summary": "多喝热水",
                "update_time": "1636965011",
                "repeat_rule": "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR"
            }
        ],
        "page_token": "MTYzMTg3ODUxNQ=="
    },
    "msg": ""
}

修改于 2025-10-21 07:33:29

查询指定任务

功能介绍

查询所有任务

错误码#

请求参数

返回响应

错误码