ClickUp

简介

ClickUp API v2 管理 ClickUp 工作区中的任务、列表、文件夹、文档和团队。认证是 API 令牌（个人令牌或 OAuth）——缺失令牌返回 HTTP 400 "Authorization header required"（已实测）。

快速开始

团队（替换 YOUR_TOKEN）：

curl "https://api.clickup.com/api/v2/team" \
  -H "Authorization: YOUR_TOKEN"

{ "teams": [ { "id": "123", "name": "My Team", "members": [] } ] }

列表中的任务：

curl "https://api.clickup.com/api/v2/list/LIST_ID/task?include_closed=true" \
  -H "Authorization: YOUR_TOKEN"

创建任务：

curl -X POST "https://api.clickup.com/api/v2/list/LIST_ID/task" \
  -H "Authorization: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "New task"}'

认证方式

• 个人令牌：ClickUp → Settings → Apps → API Token。
• 第三方应用走 OAuth 2.0。
• 通过 Authorization: YOUR_TOKEN 携带（缺失 → 400 “Authorization header required”，已实测）。

速率限制与注意事项

• 限流因套餐而异（免费：适中；付费：更高）——见文档。
• v2 API 覆盖任务、列表、文件夹、空间、文档、时间追踪。
• 团队 ID 用于限定 API 访问范围。

常见问题

ClickUp API 免费吗？ API 访问随套餐提供；免费层有限制。

如何获取令牌？ Settings → Apps → API Token。

为什么无认证 400？ ClickUp 返回 400 “Authorization header required”（已实测）——请发送 Authorization 请求头。