通过 Maton 托管 OAuth 集成 TickTick API,支持任务与项目的完整 CRUD 操作,需网络及 API Key
基本信息
- 技能名称?TickTick
- 中文名称?零配置托管 OAuth,任务项目全能管
- 作者?byungkyu
- 分类?专业技能
- 版本?1.0.3
- 标签?task-management, ticktick, oauth-proxy, maton, crud-api, gtd, project-management
使用方法
使用说明
核心用法
TickTick skill 通过 Maton 代理服务提供 TickTick Open API 的托管 OAuth 集成,允许 AI 助手对用户任务和项目进行完整生命周期管理(CRUD)。用户需先在 Maton 平台获取 API Key,并建立 TickTick OAuth 连接,之后所有 API 请求通过 https://api.maton.ai/ticktick/{path} 路由,由 Maton 自动注入 OAuth Token。
关键操作流程:
- 认证准备 :设置 MATON_API_KEY 环境变量,通过 Maton 连接管理端点创建 TickTick 连接,用户浏览器完成 OAuth 授权
- 项目管理 :支持列表、看板、时间轴三种视图模式,可创建、获取详情(含任务列表)、删除项目
- 任务操作 :完整支持任务创建、更新、完成、删除,支持优先级(0/1/3/5)、截止日期、标签、跨时区等字段
- 多账户管理 :通过 Maton-Connection 请求头指定特定连接,支持同一 API Key 管理多个 TickTick 账户
显著优点
零 OAuth 实现成本 :开发者无需处理 TickTick OAuth 2.0 流程,Maton 托管令牌刷新与存储
标准 REST 接口 :完全兼容 TickTick Open API 语义,支持 Python、JavaScript 等任意 HTTP 客户端
多租户就绪 :原生支持多连接切换,适合团队协作或代理服务场景
潜在缺点与局限性
功能范围受限 :Open API 不包含习惯追踪(Habits)、番茄钟/专注模式、全局标签管理
第三方依赖风险 :Maton 代理层为单点故障点,若服务中断则 API 不可用;官方未承诺 SLA
数据隐私考量 :任务内容需流经 Maton 服务器,尽管文档声称仅代理请求,敏感任务存在额外暴露面
速率限制不透明 :错误码包含 429,但未文档化具体限制阈值
适合人群
个人效率工具开发者、自动化工作流构建者(如将邮件/Slack 消息自动转为 TickTick 任务)
需快速集成 TickTick 而不愿投入 OAuth 工程成本的小型团队
已使用 Maton 生态连接多服务的用户
常规风险
写操作需二次确认 :文档明确要求 AI 在执行创建/更新/删除前向用户确认目标资源及预期效果,防止误操作
Token 安全 :API Key 泄露将导致连接账户完全暴露,需按环境变量规范妥善保管
OAuth 授权撤销 :用户在 TickTick 端撤销授权后,Maton 连接将失效,需重新走授权流程
💬 评论 (0)
📭 还没有评论,快来抢沙发吧!