Description
Gérez les tableaux, listes et cartes Trello via l'API REST.
Triggers
- trello
- kanban board / add a card / move a card
Instructions
Trello s'authentifie avec une clé et un token, tous deux en tant que paramètres de requête. Liez-les une fois dans config.yaml :
credentials:
bindings:
trello_key: "env:TRELLO_API_KEY"
trello: "env:TRELLO_TOKEN"Chaque appel passe ensuite la clé en query et le token via auth_param :
http_request(
url="https://api.trello.com/1/members/me/boards",
credential="trello", auth_style="query", auth_param="token",
query={"key": "<from trello_key>", "fields": "name,url"},
reason="List the operator's boards to find the target"
)Routes courantes :
| Objectif | Méthode | Chemin |
|---|---|---|
| Mes tableaux | GET | /1/members/me/boards |
| Listes sur un tableau | GET | /1/boards/{boardId}/lists |
| Cartes dans une liste | GET | /1/lists/{listId}/cards |
| Créer une carte | POST | /1/cards (idList, name, desc) |
| Déplacer une carte | PUT | /1/cards/{cardId} (idList) |
| Commenter | POST | /1/cards/{cardId}/actions/comments (text) |
Résolvez les noms en IDs avant d'écrire — l'API Trello prend des IDs, et en deviner un produit une erreur 404 peu utile plutôt qu'une erreur explicite. Listez les tableaux, trouvez la correspondance, puis listez ses listes.
L'archivage (PUT /1/cards/{id} avec closed: true) est réversible ; la suppression (DELETE /1/cards/{id}) ne l'est pas. Préférez l'archivage et indiquez lequel vous avez fait.
Verify
- Les IDs de tableau et de liste ont été résolus à partir de noms, non pas devinés
- La carte apparaît dans la liste prévue après l'écriture
- Les suppressions destructrices ont été préférées aux archives là où l'intention de l'opérateur le permettait