# 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

1. Rendez-vous sur le [portail développeur de X](https://developer.x.com/) et connectez-vous avec le compte sur lequel vous souhaitez publier vos annonces.
2. 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).*
3. 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").
4. 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**.
5. 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.
6. Naviguez ensuite vers l'onglet **Keys and Tokens** (Clés et jetons) en haut de la page.
7. 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.
8. 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.

## ⚙️ 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 :

```env
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

```

## ⚠️ 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.