Todoist

简介

Todoist 的 API 管理任务、项目和生产力数据。**重要（2026-08 实测）：/rest/v2/ 下的旧 REST 端点返回 HTTP 410 “This endpoint is deprecated”——Todoist 现在用 /api/v1/ 前缀提供 API。**请相应更新集成。

快速开始

用新的 /api/v1/ base（替换 YOUR_TOKEN）：

curl "https://api.todoist.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN"

[
  { "id": "12345", "content": "Buy milk", "project_id": "6789", "is_completed": false }
]

创建任务：

curl -X POST "https://api.todoist.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Buy milk"}'

认证方式

• OAuth 2.0 应用流程，或 Todoist 设置 → Integrations → Developer 的个人令牌。
• 通过 Authorization: Bearer YOUR_TOKEN 携带。

速率限制与注意事项

• 迁移（2026-08 实测）：/rest/v2/... 端点返回 410 Gone，提示指向 /api/v1/——请用新前缀（Sync API v9+ 也已迁移）。
• 免费层含 API 访问；重度同步有限流（见文档）。
• REST API 覆盖任务、项目、分组、标签、评论。

常见问题

Todoist API 免费吗？ 是的——API 访问随 Todoist 账号提供（有限流）。

为什么旧端点返回 410？ Todoist 弃用了 /rest/v2/ 前缀——请用 /api/v1/（2026-08 实测）。

如何获取令牌？ Settings → Integrations → Developer → API token。