Créer vos identifiants API Trello : API Key et Token d'accès

Étape 1 : Créer votre Power-Up Trello (API Key)

L’API Trello utilise un couple API Key + Token. L’API Key identifie votre application (ou connecteur), le Token autorise l’accès aux données d’un compte Trello spécifique.

Pour obtenir une API Key, vous devez créer un Power-Up Trello. Le Power-Up n’a pas besoin d’être publié : il sert simplement à identifier l’application qui appelle l’API.

Créer le Power-Up

1. Connectez-vous à Trello, puis accédez au portail développeur : https://trello.com/power-ups/admin

2. Cliquez sur Nouveauté pour créer un nouveau Power-Up

3. Renseignez un Nom descriptif (ex : Connecteur-LogicielSurMesure-Production) et un email de contact

4. Cliquez sur Créer puis, dans la page de confirmation, sur le bouton Générer une nouvelle clé d’API : l’API Key est immédiatement affichée sur la page du Power-Up

Copier l’API Key

L’API Key est une chaîne de 32 caractères. Copiez-la et stockez-la dans votre gestionnaire de secrets. Elle sera nécessaire pour l’étape suivante (génération du Token) et pour tous les appels API.

---

Étape 2 : Générer un Token d’accès

Le Token autorise l’accès aux données d’un compte Trello. Il est lié au compte qui l’a généré : ce compte doit avoir accès aux boards que le connecteur doit lire ou modifier.

Choisir le bon compte Trello

Pour un connecteur de production, il est recommandé de créer un compte Trello dédié au connecteur plutôt d’utiliser le compte d’un collaborateur :

• Le compte dédié est ajouté comme membre uniquement aux boards concernés
• Si le collaborateur quitte l’entreprise, le connecteur continue de fonctionner
• Les logs d’activité dans Trello montrent Connecteur plutôt que le nom d’un collaborateur

Générer le Token et le stocker

Depuis la page de votre Power-Up dans le portail développeur :

1. Cliquez sur le lien à la fin de la phrase vous pouvez générer manuellement un jeton (ou accédez directement à l’URL de génération avec votre API Key) Équivalant à utiliser l’url https://trello.com/1/authorize?expiration=1day&scope=read&response_type=token&key={YourAPIKey}

2. La page vous résume le scope du token en listant les espaces de travail et tableaux lié à votre compte (Vous n’avez pas la main pour en enlever). Cliquez sur Autoriser

3. Une dernière page de confirmation vous affiche la valeur du Token

Le Token est une chaîne de 64 caractères. Il est affiché une seule fois après l’autorisation. Copiez-le immédiatement dans votre gestionnaire de secrets : il ne sera plus visible ensuite.

Si vous perdez le Token, vous devrez en générer un nouveau depuis la page Clé d’API de votre Application (Power-up).

---

Étape 3 : Sécuriser et transmettre les identifiants

Stockage sécurisé

L’API Key et le Token doivent être stockés en variables d’environnement dans votre logiciel, jamais en dur dans le code source. Exemple pour un connecteur Symfony :

# .env.local (jamais versionné dans git)
TRELLO_API_KEY=votre_api_key_32_caracteres
TRELLO_TOKEN=votre_token_64_caracteres

Transmission à SmartBooster

Pour transmettre les identifiants à l’équipe SmartBooster lors de l’intégration :

• Utiliser un gestionnaire de mots de passe partagé (Bitwarden, 1Password, Dashlane)
• Ne jamais envoyer par email, SMS ou messagerie en clair (Slack, Teams, WhatsApp)
• Créer une note sécurisée avec : l’API Key, le Token et le compte Trello associé

---

Vérifier les droits et l’accès aux boards

Avant de lancer les tests d’intégration, vérifier que :

1. Le compte Trello associé au Token est bien membre des boards à synchroniser
2. Le rôle attribué sur le board est adapté : Observer pour la lecture seule, Membre pour la lecture et l’écriture
3. L’appel de test GET https://api.trello.com/1/members/me/boards?key=APIKEY&token=TOKEN retourne bien la liste des boards attendus

---

Révoquer l’accès API d’une Application que vous avez créée

Si le Token est compromis ou n’est plus nécessaire, il peut être révoqué depuis les paramètres du compte Trello :

1. Connectez-vous au compte Trello associé au Token
2. Accédez aux paramètres du compte > Applications
3. Repérez l’application ou le Power-Up correspondant et cliquez sur Révoquer

La révocation est immédiate : tous les appels API utilisant ce Token échouent avec une erreur 401.

Cette procédure n’impact que le token et conserve l’application avec son ApiKey.

Vous pouvez ensuite regénérer un token avec la méthode indiquer plus haut.

---

Références

• Portail développeur Trello (Power-Ups Admin)
• Documentation d’authentification Trello
• API REST Trello v1