TrelloDotNet 1.9.0-alpha.4

TrelloDotNet

Welcome to TrelloDotNet; a modern .NET Implementation of the Trello API.

Features

• A TrelloClient implementing the Trello API for CRUD operations on most Trello Features
• An Automation Engine and Webhook Data Reciver for handling Webhook Events from a Trello Board

Getting Started

1. Install the 'TrelloDotNet' NuGet Package (dotnet add package TrelloDotNet)
2. Retrieve your API-Key and Token
3. Create new instance of TrelloDotNet.TrelloClient
4. Locate you Ids of your Boards, List, and Cards (see video here or at the end on this ReadMe)
5. Use the TrelloClient based on the examples below and/or the Wiki.

Examples of Usage:

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

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

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

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

//Get Cards on Board
List<Card> cardsOnBoard = await trelloClient.GetCardsOnBoardAsync("<boardId>");

//Get Cards in List
List<Card> cardsInList = await trelloClient.GetCardsInListAsync("<listId>");

//Add a card
Card input = new Card("<listId>", "My Card", "My Card description");
//todo - add more about the card 
Card newCard = await client.AddCardAsync(input);

//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);

Video Guides

• Trello Developer Fundamentals
  • How to get your API-Key and Token
  • How to Find ids on a Trello Board
• TrelloDotNet
  • How to use the TrelloDotNet NuGet Package
  • E-Learning Playlist
  • Webhook
    • How to work with Webhooks (Part 1: Setup)
    • How to work with Webhooks (Part 2: Receiving Events)

Handy links

• Wiki
• Changelog
• Report an issue
• Report a security concern
• TrelloDotNet Nuget Package
• Developers LinkedIn Group
• Power-Up to locate Ids
• Trello API YouTube Playlist
• Power-Ups Admin Center for API Keys and Tokens
• Trello API Documentation
• Trello Changelog
• How to build your first Power-Up

On the subject of getting Ids from Trello

The easiest way to get Ids in Trello is to use this Power-Up to copy/paste them (Recommended)

Alternative use the share buttons in the project (require no Power-Up but more cumbersome)

The Export looks like this (search for id or use a tool to pretty-print the JSON to get a better view)

More info, bugs, or questions?

Visit the Github Page: https://github.com/rwjdk/TrelloDotNet

Have Fun 😃