如何通过ClickUp API高效获取指定用户的逾期任务列表

ClickUp作为主流的项目管理工具，支持通过API对接实现自动化任务管理，获取指定用户的逾期任务列表是很多团队的高频需求，通过API调用可以避免手动筛选的繁琐，提升管理效率。

ClickUp API基础准备

获取API Token

调用ClickUp API前需要先获取个人API Token，操作步骤如下：

• 登录ClickUp账号，进入个人设置页面
• 找到API_Token选项，点击生成或复制已有的Token
• 妥善保存Token，后续所有接口请求都需要在请求头中携带该凭证

核心接口说明

获取任务的核心接口是获取团队任务列表接口，基础信息如下：

筛选指定用户逾期任务的逻辑

逾期任务的判断标准是任务的截止时间小于当前时间，且任务状态未完成，同时需要匹配指定的用户ID。具体筛选逻辑分为三步：

1. 调用任务列表接口获取团队下的所有任务数据
2. 遍历任务列表，匹配任务的负责人ID是否等于目标用户ID
3. 检查任务的截止时间是否早于当前时间，且任务状态不是完成状态

具体实现代码示例

Python实现示例

以下是使用Python调用ClickUp API获取指定用户逾期任务的完整代码：

import requests
import time
from datetime import datetime

# 配置参数
api_token = "your_clickup_api_token"
team_id = "your_team_id"
target_user_id = "target_user_id"
current_timestamp = int(time.time() * 1000)  # 当前时间戳，单位毫秒

headers = {
    "Authorization": api_token,
    "Content-Type": "application/json"
}

# 请求任务列表接口
url = f"https://api.clickup.com/api/v2/team/{team_id}/task"
params = {
    "page": 0  # 分页参数，可根据任务总量调整
}
response = requests.get(url, headers=headers, params=params)
tasks = response.json().get("tasks", [])

# 筛选逾期任务
overdue_tasks = []
for task in tasks:
    # 获取任务负责人ID
    assignees = task.get("assignees", [])
    assignee_ids = [assignee.get("id") for assignee in assignees]
    # 检查是否是指定用户的任务
    if target_user_id not in assignee_ids:
        continue
    # 获取任务截止时间
    due_date = task.get("due_date")
    if not due_date:
        continue
    # 检查是否逾期且未完成
    if int(due_date) < current_timestamp and task.get("status", {}).get("type") != "done":
        overdue_tasks.append({
            "task_id": task.get("id"),
            "task_name": task.get("name"),
            "due_date": datetime.fromtimestamp(int(due_date)/1000).strftime("%Y-%m-%d %H:%M:%S")
        })

# 输出结果
for task in overdue_tasks:
    print(f"任务ID: {task['task_id']}, 任务名称: {task['task_name']}, 截止时间: {task['due_date']}")

JavaScript实现示例

以下是使用Node.js调用ClickUp API的实现代码：

const axios = require("axios");

// 配置参数
const apiToken = "your_clickup_api_token";
const teamId = "your_team_id";
const targetUserId = "target_user_id";
const currentTimestamp = Date.now();

const headers = {
    "Authorization": apiToken,
    "Content-Type": "application/json"
};

async function getOverdueTasks() {
    try {
        const url = `https://api.clickup.com/api/v2/team/${teamId}/task`;
        const params = { page: 0 };
        const response = await axios.get(url, { headers, params });
        const tasks = response.data.tasks || [];
        
        const overdueTasks = [];
        for (const task of tasks) {
            // 检查负责人
            const assignees = task.assignees || [];
            const assigneeIds = assignees.map(assignee => assignee.id);
            if (!assigneeIds.includes(targetUserId)) {
                continue;
            }
            // 检查截止时间
            const dueDate = task.due_date;
            if (!dueDate) {
                continue;
            }
            // 检查是否逾期且未完成
            if (Number(dueDate) < currentTimestamp && task.status?.type !== "done") {
                overdueTasks.push({
                    taskId: task.id,
                    taskName: task.name,
                    dueDate: new Date(Number(dueDate)).toLocaleString()
                });
            }
        }
        
        console.log("指定用户逾期任务列表:", overdueTasks);
    } catch (error) {
        console.error("获取任务失败:", error.message);
    }
}

getOverdueTasks();

注意事项

• ClickUp API有请求频率限制，高频调用时建议添加请求间隔，避免被限流
• 任务列表接口默认返回的任务数量有限，若团队任务较多需要遍历分页参数获取全量数据
• 用户ID可以通过ClickUp的用户管理页面或者获取团队成员接口获取，确保ID正确性
• 任务状态类型可能因团队自定义配置不同有差异，建议先调用状态接口确认完成状态的标识

实际使用中可以根据业务需求扩展功能，比如将逾期任务自动同步到通知系统，或者生成逾期任务的统计报表，进一步提升团队管理效率。

ClickUp_API逾期任务获取任务列表查询API调用修改时间：2026-07-12 09:48:30