SuperAPI AI 工具集

trello

编程与开发

查看项目

更新于 10-16 03:10

技能介绍

用途:该技能用于通过托管 OAuth 访问 Trello API,围绕项目与任务管理操作看板(boards)、列表(lists)、卡片(cards)、清单(checklists)、标签(labels)和成员(members)。

主要能力:读取当前成员及其看板;创建、更新、删除看板;获取看板下的列表、卡片和成员;创建、更新、归档列表、移动列表内全部卡片;创建、更新、移动、删除卡片,添加评论、成员和标签;创建清单与清单项并更新其完成状态;创建、更新、删除标签;按关键词搜索卡片、看板等对象。

使用方式:基础地址为 https://gateway.maton.ai/trello/{native-api-path},网关会代理到 api.trello.com 并注入 OAuth 令牌。所有请求需携带头部 Authorization: Bearer $MATON_API_KEY,环境变量可设置 export MATON_API_KEY="YOUR_API_KEY"。密钥需在 maton.ai 登录后于设置页获取。OAuth 连接在 https://ctrl.maton.ai 管理,可列出、创建、查询和删除连接;创建后需在浏览器打开返回的 url 完成授权。存在多个连接时可用 Maton-Connection 头指定,省略则使用默认(最早)的活动连接。

示例:获取当前用户看板可请求 GET https://gateway.maton.ai/trello/1/members/me/boards;创建卡片向 /trello/1/cards 发送 JSON,如 {"name": "New Task", "idList": "LIST_ID", "desc": "Task description"}。

限制与注意事项:ID 为 24 位字母数字字符串;me 表示已认证用户;日期用 ISO 8601;pos 可为 top、bottom 或正数;限速为每账户每秒 10 次请求,超限返回 429;缺连接或请求无效返回 400,密钥无效返回 401,对象不存在返回 404。部分查询支持 fields、filter 等参数以精简返回。使用 curl 且 URL 含方括号时需加 -g;管道到 jq 等命令时环境变量可能无法正确展开。其他收费、平台支持等资料暂未提供。