SuperAPI AI 工具集

trello

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:通过 Trello REST API 操作 Trello 的看板、列表和卡片,可用于把 Trello 集成进自动化工作流。

适用场景:创建和管理看板;创建列表;创建、更新、移动、归档卡片;为卡片添加标签和到期时间;跨看板搜索卡片;在卡片与看板上添加成员。

不适用:需要实时同步、需要 Trello Power-Up 功能、以及大批量操作(受速率限制)的场景。

准备条件:在 https://trello.com/app-key 获取 API Key 和 Token,然后设置环境变量: export TRELLO_API_KEY="your_api_key" export TRELLO_TOKEN="your_token"

主要能力(基于 curl 调用 API):

  • 看板:列出我的看板 GET /1/members/me/boards、获取详情 GET /1/boards/BOARD_ID、创建 POST /1/boards、归档 PUT /1/boards/BOARD_ID/closed。
  • 列表:获取看板列表 GET /1/boards/BOARD_ID/lists、创建 POST /1/lists、归档 PUT /1/lists/LIST_ID/closed。
  • 卡片:获取列表卡片 GET /1/lists/LIST_ID/cards、创建 POST /1/cards、获取 GET /1/cards/CARD_ID、更新 PUT /1/cards/CARD_ID、移动到其他列表(传 idList)、归档 PUT /1/cards/CARD_ID/closed、加标签 POST /1/cards/CARD_ID/labels、设到期时间(更新卡片字段 due)。
  • 搜索:GET /1/search?query={term},可用 cards_limit 等参数过滤。
  • 成员:把成员加入看板 PUT /1/boards/BOARD_ID/members/USER_ID,加入卡片 POST /1/cards/CARD_ID/members。

命令示例(保留原样): curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name: .name, id: .id}' curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" -H "Content-Type: application/json" -d '{"name": "New Task", "idList": "LIST_ID", "desc": "Task description"}' curl -s -X PUT "https://api.trello.com/1/cards/CARD_ID?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" -H "Content-Type: application/json" -d '{"idList": "NEW_LIST_ID"}'

限制与注意:速率限制约每秒 10 个请求;看板 ID 非人类可读;需用 jq 解析 JSON;卡片同时有长 id 和数字 idShort,用户友好引用建议用 idShort。资料中关于收费、价格、具体平台支持范围暂未提供。