Trello4j

Introduction

trello4j is a java wrapper around Trello API.

You need to get a API key and optionally generate a token here to be able to use Trello's API.

Please report any issues and/or participate in the development here :)

Getting started

Get trello4j from unofficial maven repo

<repository>
    <id>joelso-mvn-repo</id>
    <name>joelso github mvn repo</name>
    <url>https://raw.github.com/joelso/joelso-mvn-repo/master/snapshots/</url>
</repository>

...

<dependency>
    <groupId>org.trello4j</groupId>
	<artifactId>trello4j</artifactId>
	<version>1.0-SNAPSHOT</version>
</dependency>

Get source and build it

git clone git@github.com:joelso/trello4j.git
cd trello4j
mvn install

Now you got two options:

1. Use trello4j from your local maven repo, add dependency groupId: org.trello4j / artifactId: trello4j
2. Use jar that was built in directory target/

Usage

// myToken is optional, set to null if you are accessing public data
Trello trello = new TrelloImpl("myApiKey", "myToken");  

// example: get organization by its name
Organization org = trello.getOrganization("fogcreek");

<table> <tr><th>Method</th><th>Version</th></tr> <tr><th colspan="2">Actions</th></tr> <tr><td>GET /1/actions/[action_id]</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/board</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/board/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/card</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/card/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/list</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/list/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/member</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/member/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/memberCreator</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/memberCreator/[field]</td> <td>TODO</td></tr> <tr><td>GET /1/actions/[action_id]/organization</td> <td>IMPLEMENTED</td></tr> <tr><td>GET /1/actions/[action_id]/organization/[field]</td> <td>TODO</td></tr> <tr><th colspan="2">Boards</th></tr> <tr><td>GET /1/boards/[board_id] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/[field] </td><td>TODO</td></tr> <tr><td>GET /1/boards/[board_id]/actions </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/cards </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/cards/[filter] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/cards/[idCard] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/checklists </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/lists </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/lists/[filter] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/members </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/members/[filter] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/membersInvited </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/membersInvited/[field]</td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/myPrefs </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/organization </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/boards/[board_id]/organization/[field] </td><td>IMPLEMENTED</td></tr> <tr><td>PUT /1/boards/[board_id] </td><td>TODO</td></tr> <tr><td>PUT /1/boards/[board_id]/closed </td><td>TODO</td></tr> <tr><td>PUT /1/boards/[board_id]/desc </td><td>TODO</td></tr> <tr><td>PUT /1/boards/[board_id]/name </td><td>TODO</td></tr> <tr><td>POST /1/boards </td><td>TODO</td></tr> <tr><td>POST /1/boards/[board_id]/checklists </td><td>TODO</td></tr> <tr><td>POST /1/boards/[board_id]/lists </td><td>TODO</td></tr> <tr><td>POST /1/boards/[board_id]/myPrefs </td><td>TODO</td></tr> <tr><th colspan="2">Cards</th></tr> <tr><td>GET /1/cards/[card_id] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/[field] </td><td>TODO</td></tr> <tr><td>GET /1/cards/[card_id]/actions </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/attachments </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/board </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/board/[field] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/checkItemStates </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/checklists </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/list </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/cards/[card_id]/list/[field] </td><td>TODO</td></tr> <tr><td>GET /1/cards/[card_id]/members </td><td>IMPLEMENTED</td></tr> <tr><td>PUT /1/cards/[card_id] </td><td>TODO</td></tr> <tr><td>PUT /1/cards/[card_id]/closed </td><td>TODO</td></tr> <tr><td>PUT /1/cards/[card_id]/desc </td><td>TODO</td></tr> <tr><td>PUT /1/cards/[card_id]/due </td><td>TODO</td></tr> <tr><td>PUT /1/cards/[card_id]/idList </td><td>TODO</td></tr> <tr><td>PUT /1/cards/[card_id]/name </td><td>TODO</td></tr> <tr><td>POST /1/cards </td><td>IMPLEMENTED</td></tr> <tr><td>POST /1/cards/[card_id]/actions/comments </td><td>TODO</td></tr> <tr><td>POST /1/cards/[card_id]/attachments </td><td>TODO</td></tr> <tr><td>POST /1/cards/[card_id]/checklists </td><td>TODO</td></tr> <tr><td>POST /1/cards/[card_id]/labels </td><td>TODO</td></tr> <tr><td>POST /1/cards/[card_id]/members </td><td>TODO</td></tr> <tr><td>POST /1/cards/[card_id]/membersVoted </td><td>TODO</td></tr> <tr><td>DELETE /1/cards/[card_id] </td><td>TODO</td></tr> <tr><td>DELETE /1/cards/[card_id]/checklists/[idChecklist] </td><td>TODO</td></tr> <tr><td>DELETE /1/cards/[card_id]/labels/[color] </td><td>TODO</td></tr> <tr><td>DELETE /1/cards/[card_id]/members/[idMember] </td><td>TODO</td></tr> <tr><td>DELETE /1/cards/[card_id]/membersVoted/[idMember] </td><td>TODO</td></tr> <tr><th colspan="2">Checklists</th></tr> <tr><td>GET /1/checklists/[checklist_id] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/checklists/[checklist_id]/[field] </td><td>TODO</td></tr> <tr><td>GET /1/checklists/[checklist_id]/board </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/checklists/[checklist_id]/board/[field] </td><td>TODO</td></tr> <tr><td>GET /1/checklists/[checklist_id]/cards </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/checklists/[checklist_id]/cards/[filter] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/checklists/[checklist_id]/checkItems </td><td>IMPLEMENTED</td></tr> <tr><td>PUT /1/checklists/[checklist_id] </td><td>TODO</td></tr> <tr><td>PUT /1/checklists/[checklist_id]/name </td><td>TODO</td></tr> <tr><td>POST /1/checklists </td><td>TODO</td></tr> <tr><td>POST /1/checklists/[checklist_id]/checkItems </td><td>TODO</td></tr> <tr><td>DELETE /1/checklists/[checklist_id]/checkItems/[idCheckItem] </td><td>TODO</td></tr> <tr><th colspan="2">Lists</th></tr> <tr><td>GET /1/lists/[list_id] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/lists/[list_id]/[field] </td><td>TODO</td></tr> <tr><td>GET /1/lists/[list_id]/actions </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/lists/[list_id]/board </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/lists/[list_id]/board/[field] </td><td>TODO</td></tr> <tr><td>GET /1/lists/[list_id]/cards </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/lists/[list_id]/cards/[filter] </td><td>IMPLEMENTED</td></tr> <tr><td>PUT /1/lists/[list_id] </td><td>TODO</td></tr> <tr><td>PUT /1/lists/[list_id]/closed </td><td>TODO</td></tr> <tr><td>PUT /1/lists/[list_id]/name </td><td>TODO</td></tr> <tr><td>POST /1/lists </td><td>TODO</td></tr> <tr><td>POST /1/lists/[list_id]/cards </td><td>TODO</td></tr> <tr><th colspan="2">Members</th></tr> <tr><td>GET /1/members/[member_id or username] </td><td>IMPLEMENTED</td></tr> <tr><td>GET /1/members/[member_id or username]/[field] </td><td>TODO</td></tr> <tr><td>GET