Obtenir les identifiants API X (Twitter)
Ce guide explique pas à pas comment générer et récupérer les clés d'API (Consumer Keys et Access Tokens) depuis le portail développeur de X (anciennement Twitter) afin de permettre à Podcast Utilities de publier des messages.
🎯 Objectif
Dans l'écosystème de Podcast Utilities, l'intégration X permet d'automatiser la publication de tweets sur votre compte (par exemple, pour annoncer la mise en ligne d'un nouvel épisode).
Pour autoriser l'application à interagir et publier en votre nom, vous devez générer et fournir quatre clés d'authentification distinctes : X_CONSUMER_KEY, X_CONSUMER_SECRET, X_ACCESS_TOKEN et X_ACCESS_TOKEN_SECRET.
📝 Étapes à suivre
- Rendez-vous sur le portail développeur de X et connectez-vous avec le compte sur lequel vous souhaitez publier vos annonces.
- Accédez au tableau de bord (Developer Portal). Note : S'il s'agit de votre première visite, il vous sera demandé de vous inscrire au niveau d'accès développeur gratuit (Free tier).
- Dans le menu de gauche, sous Projects & Apps, cliquez sur votre application par défaut (ou créez-en une nouvelle en cliquant sur "Add App").
- Avant de générer les clés, vous devez configurer les droits. Allez dans les paramètres de l'application et repérez la section User authentication set up (Configuration de l'authentification). Cliquez sur Edit.
- C'est l'étape la plus importante : sous "App permissions", sélectionnez impérativement Read and Write (Lecture et Écriture) pour que le script puisse publier. Sauvegardez.
- Naviguez ensuite vers l'onglet Keys and Tokens (Clés et jetons) en haut de la page.
- Dans la section Consumer Keys, cliquez sur Generate (Générer) pour obtenir votre API Key (
X_CONSUMER_KEY) et votre API Key Secret (X_CONSUMER_SECRET). Copiez-les. - Dans la section Authentication Tokens, cliquez sur Generate pour obtenir votre Access Token (
X_ACCESS_TOKEN) et votre Access Token Secret (X_ACCESS_TOKEN_SECRET). Copiez-les également.
⚠️ Points d'attention
Affichage unique : Le portail développeur de X n'affiche vos clés secrètes qu'une seule et unique fois lors de leur création. Si vous ne les copiez pas immédiatement, vous devrez les regénérer (ce qui invalidera les précédentes).
Limites du compte : Le niveau gratuit (Free tier) de l'API X permet de publier jusqu'à 1 500 tweets par mois, ce qui est largement suffisant pour l'automatisation de vos épisodes.
Sécurité : Ces clés agissent comme un accès total à votre compte. Ne les partagez sous aucun prétexte.
⚙️ Intégration dans le fichier .env
Retournez dans votre fichier .env à la racine de votre dossier de déploiement, et collez ces quatre valeurs face aux variables correspondantes :
X_CONSUMER_KEY=collez_votre_api_key_ici
X_CONSUMER_SECRET=collez_votre_api_key_secret_ici
X_ACCESS_TOKEN=collez_votre_access_token_ici
X_ACCESS_TOKEN_SECRET=collez_votre_access_token_secret_ici