Trellodotnetassistant

TrelloDotNet

欢迎使用 TrelloDotNet - Trello REST API 的 .NET 实现

功能

• 用于对 Trello 功能进行 CRUD 操作的 TrelloClient
• 用于处理 webhook 事件的 Automation Engine 和 Webhook Data Receiver

快速开始

要开始使用，你可以按照以下步骤操作，或使用 TrelloDotNet MCP Server 让 AI 协助你并 Vibe Code 整个项目 8-)

1. 安装 'TrelloDotNet' NuGet 包（dotnet add package TrelloDotNet）
2. 从 Power-Ups Administration 获取你的 API Key 和 Token
3. 创建 TrelloClient 的新实例 （位于命名空间 'TrelloDotNet' 中）
4. 找到你的 Boards、Lists 和 Cards 的 ID（参见此处的视频或本 README 末尾）
5. 根据以下示例和/或 [Wiki](https://github.com/rwjdk/trello-dotnet/ 使用 TrelloClient

使用示例：

TrelloClient client = new TrelloDotNet.TrelloClient("APIKEY", "TOKEN"); //IMPORTANT: Remember to NOT leave Key and Token in clear text!

//Get all boards that the Token Owner can access
List<Board> boards = await client.GetBoardsCurrentTokenCanAccessAsync();

//Get a specific board
Board board = await client.GetBoardAsync("<boardId>");

//Get lists on a board
List<List> lists = await client.GetListsOnBoardAsync("<boardId>");

//Get cards on a board
List<Card> cardsOnBoard = await client.GetCardsOnBoardAsync("<boardId>");

//Get cards in a specific list
List<Card> cardsInList = await client.GetCardsInListAsync("<listId>");

//Get a specific card
Card card = await client.GetCardAsync("<cardId>");

//Add a card (simple)
AddCardOptions newCardOptions = new AddCardOptions("<listId>", "My Card", "My Card description");
Card newCard = await client.AddCardAsync(newCardOptions);

//Add a card (advanced, with all options set)
Card newAdvancedCard = await client.AddCardAsync(new AddCardOptions
{
    //Required options
    ListId = "<listId>",
    Name = "My Card",

    //Optional options
    Description = "Description of My Card",
    Start = DateTimeOffset.Now,
    Due = DateTimeOffset.Now.AddDays(3),
    Cover = new CardCover(CardCoverColor.Blue, CardCoverSize.Normal),
    LabelIds = new List<string>
    {
        "<labelId1>",
        "<labelId2>",
    },
    MemberIds = new List<string>
    {
        "<memberId1>",
        "<memberId2>"
    },
    Checklists = new List<Checklist>
    {
        new Checklist("Checklist 1", new List<ChecklistItem>
        {
            new ChecklistItem("Item 1"),
            new ChecklistItem("Item 2"),
            new ChecklistItem("Item 3")
        }),
        new Checklist("Checklist 2", new List<ChecklistItem>
        {
            new ChecklistItem("Item A"),
            new ChecklistItem("Item B"),
            new ChecklistItem("Item C")
        }),
    },
    AttachmentUrlLinks = new List<AttachmentUrlLink>
    {
        new AttachmentUrlLink("https://www.google.com", "Google")
    },
    AttachmentFileUploads = new List<AttachmentFileUpload>
    {
        new AttachmentFileUpload(File.OpenRead(@"<pathToFile>"), "<Filename>", "<FileDescription>")
    },
    CustomFields = new List<AddCardOptionsCustomField>
    {
        new AddCardOptionsCustomField(customField1OnBoard, "ABC"),
        new AddCardOptionsCustomField(customField2OnBoard, 123),
    }
});

//Update a card (with new name and description and removal of Due Date)
var updateCard = await client.UpdateCardAsync("<cardId>", [
    CardUpdate.Name("New Name"),
    CardUpdate.Description("New Description"),
    CardUpdate.DueDate(null),
]);

//Add a checklist to a card
var checklistItems = new List<ChecklistItem>
{
    new("ItemA"),
    new("ItemB"),
    new("ItemC")
};
Checklist newChecklist = new Checklist("Sample Checklist", checklistItems);
Checklist addedChecklist = await client.AddChecklistAsync("<cardId>", newChecklist);

视频指南

• Trello 开发者基础
  • 如何获取你的 API Key 和 Token
  • 如何在 Trello Board 上找到 ID
• TrelloDotNet
  • 如何使用 TrelloDotNet NuGet 包
  • 电子学习播放列表
  • Webhook
    • 如何使用 Webhook（第 1 部分：设置）
    • 如何使用 Webhook（第 2 部分：接收事件）

便捷链接

• Udemy 课程
• Wiki
• 更新日志
  • 2.0 版迁移指南
• 报告问题
• 报告安全问题
• TrelloDotNet NuGet 包
• 开发者 LinkedIn 群组
• 用于查找 ID 的 Power-Up
• Trello API YouTube 播放列表
• 用于管理 API 密钥和令牌的 Power-Ups 管理中心
• Trello API 文档
• Trello 更新日志
• 如何构建你的第一个 Power-Up

关于从 Trello 获取 ID

在 Trello 中获取 ID 最简单的方法是使用这个 Power-Up 来复制/粘贴它们（推荐）。

或者，使用项目中的分享按钮（无需 Power-Up，但更加繁琐）。

导出的内容如下所示（搜索 ID，或使用工具美化打印 JSON 以获得更好的查看效果）：

祝玩得开心！