ClickUp API：高效获取指定用户逾期任务列表的专业指南

https://app.clickup.com/home/team/{team_id}/inbox

{
  "userid": "user_id",
  "overdue_only": true,
  "sort_by": "dueDate",
  "sort_dir": -1,
  "reminder_position": "top"
}

https://api.clickup.com/api/v2/team/{team_id}/task

https://api.clickup.com/api/v2/team/%team_id%/task?assignees[]=%assignee_id%&due_date_lt=%unix_time_with_millisecinds%

import requests
import time
import json

# 配置您的ClickUp API信息
API_TOKEN = "YOUR_API_TOKEN"  # 替换为您的ClickUp API令牌
TEAM_ID = "YOUR_TEAM_ID"      # 替换为您的团队ID
ASSIGNEE_ID = "YOUR_ASSIGNEE_ID" # 替换为您要查询的用户的ID

# 获取当前时间的Unix时间戳（毫秒）
# 任何截止日期早于此时间戳的任务都将被视为逾期
current_unix_timestamp_ms = int(time.time() * 1000)

# 构建API请求URL
base_url = f"https://api.clickup.com/api/v2/team/{TEAM_ID}/task"
params = {
    "assignees[]": ASSIGNEE_ID,
    "due_date_lt": current_unix_timestamp_ms,
    # 可选参数：
    # "page": 0, # 如果结果分页，可以指定页码
    # "order_by": "due_date", # 按截止日期排序
    # "reverse": True # 倒序
}
headers = {
    "Authorization": API_TOKEN,
    "Content-Type": "application/json"
}

print(f"请求URL: {base_url}?assignees[]={ASSIGNEE_ID}&due_date_lt={current_unix_timestamp_ms}")
print(f"当前Unix时间戳 (毫秒): {current_unix_timestamp_ms}")

try:
    response = requests.get(base_url, headers=headers, params=params)
    response.raise_for_status()  # 如果请求失败，抛出HTTPError异常

    tasks_data = response.json()

    if tasks_data and tasks_data.get('tasks'):
        print(f"\n找到 {len(tasks_data['tasks'])} 个逾期任务：")
        for task in tasks_data['tasks']:
            print(f"- 任务ID: {task['id']}, 名称: {task['name']}, 状态: {task['status']['status']}, 截止日期: {time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(int(task['due_date']) / 1000)) if 'due_date' in task else '无'}")
    else:
        print("未找到逾期任务或响应为空。")

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP错误发生: {http_err}")
    print(f"响应内容: {response.text}")
except requests.exceptions.ConnectionError as conn_err:
    print(f"连接错误发生: {conn_err}")
except requests.exceptions.Timeout as timeout_err:
    print(f"请求超时: {timeout_err}")
except requests.exceptions.RequestException as req_err:
    print(f"发生未知请求错误: {req_err}")
except json.JSONDecodeError as json_err:
    print(f"JSON解析错误: {json_err}")
    print(f"原始响应内容: {response.text}")

# 请将 YOUR_API_TOKEN, YOUR_TEAM_ID, YOUR_ASSIGNEE_ID 替换为您的实际值
# 并将 CURRENT_UNIX_TIMESTAMP_MS 替换为当前时间的毫秒级Unix时间戳
# 例如，如果当前时间是 2023-10-27 10:00:00 UTC，其毫秒级Unix时间戳为 1698391200000
CURRENT_UNIX_TIMESTAMP_MS=$(date +%s%3N) # 获取当前毫秒级Unix时间戳 (Linux/macOS)

curl -X GET \
  "https://api.clickup.com/api/v2/team/YOUR_TEAM_ID/task?assignees%5B%5D=YOUR_ASSIGNEE_ID&due_date_lt=${CURRENT_UNIX_TIMESTAMP_MS}" \
  -H "Authorization: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"