滴答清单官方 API 任务管理

TickTick 官方 API 集成的任务管理工具，支持项目/任务列表查询、增删改查及完成标记，需 OAuth 授权。

基本信息

• 技能名称?TickTick API
• 中文名称?滴答清单官方 API 任务管理
• 作者?kaiofreitas
• 分类?专业技能
• 版本?1.0.0
• 标签?task-management, gtd, todo, api-integration, oauth, cli-tool, ticktick, productivity

使用方法

使用说明
核心用法
TickTick Integration 是基于滴答清单官方 Open API 的命令行工具，提供完整的任务管理功能。首次使用需通过 ticktick-setup 完成 OAuth 2.0 授权流程，获取访问令牌后可持续使用。
主要功能：
项目查看 ： ticktick projects 列出所有项目（清单）
任务管理 ：支持按项目筛选、添加任务（可指定截止日期和优先级）、完成任务、删除任务
批量操作 ：可快速处理多任务状态变更
API 覆盖 ：完整对接滴答清单 v1 开放接口，包括项目数据获取、任务 CRUD、完成状态切换等核心端点。
显著优点

1. 官方 API 背书 ：基于 TickTick 官方开放平台，数据同步稳定可靠
2. 功能闭环 ：涵盖任务管理全生命周期，从创建到归档
3. 日期支持 ：支持 ISO 8601 格式截止日期，便于自动化提醒
4. 优先级体系 ：0/1/3/5 四级优先级，适配 GTD 工作流
   潜在局限
   OAuth 门槛 ：首次配置需开发者账号注册、回调 URI 设置，对普通用户有一定技术门槛
   本地回调 ：依赖 127.0.0.1:8765 本地端口，容器/远程环境需额外网络配置
   功能边界 ：不支持重复任务规则设置、子任务层级管理、附件上传等高级功能
   速率限制 ：官方 API 存在调用频率限制，高频自动化场景可能受限
   适合人群
   已将 TickTick 作为主力 GTD 工具的开发者/技术用户
   需要 CLI/脚本化任务管理的自动化工作流搭建者
   希望通过 API 将任务系统与其他工具（如日历、IM）集成的进阶用户
   常规风险
   令牌安全 ：OAuth token 存储于本地，多用户环境需关注文件权限
   数据误操作 ： delete 操作不可逆，批量脚本需增加确认机制
   授权过期 ：长期未使用需重新授权，自动化任务可能因此中断