Glento API
隨時隨地讀取、建立、更新、完成和刪除矩陣中的任務。包含在 Pro 中,不必管理 API 金鑰。
三種串接方式
Beta
免寫程式
透過 Zapier 連結
不用寫任何程式,就能把 Glento 串接到數千個 App。兩種觸發條件、四種動作和一種搜尋,涵蓋建立、更新、完成和刪除。目前為邀請制的不公開 Beta。
取得 Zapier 邀請連結帳號
不需要複製 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 狀態。可用來測試連結。 |
基礎網址 https://api.glento.ai/functions/v1. 完整的結構定義(包括每個任務欄位)位於 /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. 刪除看得見,不會悄悄消失
已刪除的任務會以設定了 deleted_at 的狀態出現在 updated_since 輪詢中,讓你的自動化流程可以做出反應,而不是逐漸脫節。不會有任何東西在你不知情時被永久刪除。
3. 重複設定本身是唯讀的
重複任務的讀取和編輯方式和其他任務一樣:變更標題、備註、優先等級或象限都會正常運作。API 目前還不能變更重複設定、完成或取消完成屬於某個系列的任務,也不能為它設定或清除開始日期,以免系列在不知不覺中被破壞。
想打造的東西我們還沒涵蓋到?歡迎聯絡我們,告訴我們你的需求。 聯絡我們