Glento API
随时随地读取、创建、更新、完成和删除矩阵中的任务。Pro 已包含,无需管理 API 密钥。
三种接入方式
连接账户
没有要复制的 API 密钥,也不用交出密码。工具把你带到 Glento,你登录,看清对方请求了什么,然后批准。连接会自行刷新,你在工具中移除它的那一刻就会停止。
需要 Pro 才能进行任何涉及任务的操作。连接测试本身在任何账户上都能用,所以工具可以告诉你缺的是 Pro,而不是莫名其妙地失败。
端点
| 方法 | 路径 | 作用 |
|---|---|---|
| GET | /tasks | 列出任务,可按象限或状态筛选。用 updated_since 轮询,可看到所有变更,包括删除。 |
| GET | /tasks/{id} | 单个任务。 |
| POST | /tasks | 创建。附上 Idempotency-Key,重试不会重复创建。 |
| PATCH | /tasks/{id} | 修改字段、完成或取消完成、移动象限、重新排序。省略字段则保持不变,发送 null 则清除。 |
| DELETE | /tasks/{id} | 删除。重复调用返回 204,重试是安全的。 |
| GET | /me | 账户和 Pro 状态。用它来测试连接。 |
基础 URL https://api.glento.ai/functions/v1. 完整的 schema(包含任务的每个字段)位于 /openapi,与本页不一致时以它为准。glento.ai/llms.txt 会把 AI 工具指向它。
速率限制为每个账户每分钟 60 次请求。每页 50 个任务,最多 200 个。错误格式始终是 { error, code }。
三条值得了解的规则
1. 日期带时区
到期日和开始日是“天”,不是时刻。设置日期或按状态筛选时,请一并发送 IANA 时区,日期就会落在你想要的那一天。不带时区的请求会被拒绝,而不是靠猜。
{ "title": "续费域名", "quadrant": "important_not_urgent",
"due_date": "2026-09-30", "timezone": "America/Chicago" }2. 删除是可见的,不是悄无声息的
已删除的任务会出现在 updated_since 轮询中,并带有 deleted_at,这样你的自动化可以做出反应,而不是渐渐失去同步。不会在你不知情的情况下彻底删除任何东西。
3. 重复设置本身是只读的
重复任务和其他任务一样可以读取和编辑:修改标题、备注、优先级或象限,都正常生效。API 目前不会做的是修改重复设置、完成或取消完成属于某个系列的任务,以及为其设置或清除开始日期,这样系列就不会被悄悄破坏。
在做我们没有覆盖到的东西?联系我们,告诉我们你需要什么。 联系我们