技术问询：如何获取Trello列表顶部卡片并推送至Discord频道

刚好做过类似的需求，我来一步步帮你搞定这个问题。核心关键点是理解Trello如何排序卡片，然后结合API调用拿到顶部卡片，再发送到Discord。

一、获取Trello列表顶部卡片的通用逻辑 #

Trello列表里的卡片顺序是由pos（位置）字段决定的：列表最顶部的卡片pos值最小，越往下值越大。所以不管用什么语言，只要调用Trello API时指定按pos升序排序，返回结果的第一个元素就是你要的顶部卡片。

核心API调用说明 #

你需要调用Trello的GET /lists/{idList}/cards接口，加上以下参数：

• sort=pos：按位置字段排序
• order=asc：升序排列（这样最小的pos值排在最前面）
• key和token：你的Trello API凭证（可以在Trello开发者页面获取）
• 可选fields=name：只返回卡片名称，减少不必要的数据传输

比如用curl直接测试的话，命令是：

curl "https://api.trello.com/1/lists/{你的列表ID}/cards?sort=pos&order=asc&key={你的API Key}&token={你的Token}"

返回的JSON数组第一个对象就是顶部卡片。

二、完整实现：获取卡片并发送到Discord #

下面用Python和JavaScript两种常用语言给出完整示例，你可以根据自己的技术栈选择：

Python版本（用requests库） #

import requests

# 替换成你的配置信息
TRELLO_API_KEY = "你的Trello API Key"
TRELLO_TOKEN = "你的Trello Token"
LIST_ID = "目标列表的ID（从Trello页面URL里获取）"
DISCORD_WEBHOOK_URL = "Discord频道的Webhook地址"

def get_top_trello_card():
    """获取指定列表的顶部卡片名称"""
    url = f"https://api.trello.com/1/lists/{LIST_ID}/cards"
    params = {
        "sort": "pos",
        "order": "asc",
        "key": TRELLO_API_KEY,
        "token": TRELLO_TOKEN,
        "fields": "name"  # 仅获取名称字段，优化性能
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # 捕获API调用错误
        cards = response.json()
        return cards[0]["name"] if cards else None
    except Exception as e:
        print(f"获取卡片失败：{str(e)}")
        return None

def send_to_discord(message):
    """将消息发送到Discord频道"""
    if not message:
        print("列表中没有卡片可发送")
        return
    try:
        payload = {"content": f"📋 当前Trello列表顶部卡片：{message}"}
        response = requests.post(DISCORD_WEBHOOK_URL, json=payload)
        response.raise_for_status()
        print("消息已成功发送到Discord")
    except Exception as e:
        print(f"发送到Discord失败：{str(e)}")

if __name__ == "__main__":
    top_card = get_top_trello_card()
    send_to_discord(top_card)

JavaScript版本（Node.js环境，用node-fetch） #

const fetch = require('node-fetch');

// 替换成你的配置信息
const TRELLO_CONFIG = {
    apiKey: "你的Trello API Key",
    token: "你的Trello Token",
    listId: "目标列表的ID"
};
const DISCORD_WEBHOOK_URL = "Discord频道的Webhook地址";

async function getTopTrelloCard() {
    const url = `https://api.trello.com/1/lists/${TRELLO_CONFIG.listId}/cards`;
    const params = new URLSearchParams({
        sort: "pos",
        order: "asc",
        key: TRELLO_CONFIG.apiKey,
        token: TRELLO_CONFIG.token,
        fields: "name"
    });

    try {
        const response = await fetch(`${url}?${params}`);
        const cards = await response.json();
        return cards.length > 0 ? cards[0].name : null;
    } catch (err) {
        console.error("获取卡片失败：", err);
        return null;
    }
}

async function sendToDiscord(message) {
    if (!message) {
        console.log("列表为空，无卡片可发送");
        return;
    }
    try {
        await fetch(DISCORD_WEBHOOK_URL, {
            method: "POST",
            headers: { "Content-Type": "application/json" },
            body: JSON.stringify({ content: `📋 当前Trello列表顶部卡片：${message}` })
        });
        console.log("消息已发送到Discord");
    } catch (err) {
        console.error("发送到Discord失败：", err);
    }
}

// 执行流程
getTopTrelloCard().then(sendToDiscord);

三、注意事项 #

• 如何获取Trello列表ID？ 打开目标列表的网页，URL里的idList参数就是列表ID（比如https://trello.com/b/xxxxxx/xxx?idList=60d21bxxxxxxxxx，等号后面的字符串就是）。
• Discord Webhook怎么创建？ 打开Discord频道设置，找到「集成」→「Webhook」，点击「新建Webhook」，复制生成的URL即可。
• 异常处理 示例里加了基本的错误捕获，实际使用时可以根据需求扩展（比如重试机制、日志记录等）。

内容的提问来源于stack exchange，提问作者lightvng