Trello

简介

Trello API 开放看板项目管理工具的面板、列表、卡片、成员和动态。公开面板无需密钥即可读取（实测可用——Trello Development Roadmap 面板匿名返回 JSON）；私有数据和写操作需要 API 密钥 + token（OAuth 风格）。

快速开始

公开面板——无需密钥（实测可用）：

curl "https://api.trello.com/1/boards/4d5ea62fd76aa1136000000c"

{
  "id": "4d5ea62fd76aa1136000000c",
  "name": "Trello Development Roadmap",
  "desc": "## Welcome to the Trello Roadmap! ...",
  "url": "https://trello.com/b/nC8QJJoZ/trello-development-roadmap"
}

面板的列表：

curl "https://api.trello.com/1/boards/4d5ea62fd76aa1136000000c/lists"

列表中的卡片（公开数据，无需密钥）：

curl "https://api.trello.com/1/lists/{listId}/cards"

带 key + token（私有面板、写操作）：

curl "https://api.trello.com/1/boards/{boardId}?key=YOUR_KEY&token=YOUR_TOKEN"

认证方式

• 匿名：公开面板/列表/卡片无需密钥可读（实测）。
• API 密钥 + token：在 trello.com/power-ups/admin（或开发者站点）生成——私有数据和变更需要（创建卡片、移动列表……）。
• Token 是用户级作用域；请像密码一样对待。

速率限制与注意事项

• 公开读取实际无限制；带认证的调用有按密钥限额（见文档）。
• 面板/列表/卡片 ID 是稳定的字母数字串。
• 用 ?cards=open&card_fields=name 等参数精简响应。
• API 是带 /1/ 前缀的 REST；webhook 可用于实时更新。

常见问题

Trello API 免费吗？ 是的——公开读取免密钥；key+token 对多数用途免费。

需要 token 吗？ 只有私有面板和写操作需要——公开数据匿名可读。

如何获取密钥？ trello.com/power-ups/admin → 创建 power-up → 复制 API key。