name: trello description: 通过Trello REST API管理Trello看板、列表和卡片。 homepage: https://developer.atlassian.com/cloud/trello/rest/ metadata: { “otto”: { “emoji”: “📋”, “requires”: { “bins”: [“jq”], “env”: [“TRELLO_API_KEY”, “TRELLO_TOKEN”] } }, }
Trello技能
直接从Otto管理Trello看板、列表和卡片。
设置
- 获取您的API密钥:https://trello.com/app-key
- 生成一个令牌(点击该页面上的“令牌”链接)
- 设置环境变量:
export TRELLO_API_KEY="您的API密钥" export TRELLO_TOKEN="您的令牌"
使用
所有命令使用curl调用Trello REST API。
列出看板
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出看板中的列表
curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出列表中的卡片
curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
创建卡片
curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={listId}" \
-d "name=卡片标题" \
-d "desc=卡片描述"
将卡片移动到另一个列表
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={newListId}"
向卡片添加评论
curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "text=您的评论在这里"
归档卡片
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "closed=true"
注意事项
- 看板/列表/卡片ID可以在Trello URL中找到或通过列表命令获取
- API密钥和令牌提供对您Trello账户的完全访问权限 - 请保密!
- 速率限制:每个API密钥每10秒300个请求;每个令牌每10秒100个请求;
/1/members端点限制为每900秒100个请求
示例
# 获取所有看板
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq
# 按名称查找特定看板
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("工作"))'
# 获取看板上的所有卡片
curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'