--- title: "Bien démarrer avec l’API REST" description: "Créez un jeton d’accès, choisissez les portées et lisez les campagnes, les leads et les listes depuis vos propres systèmes." url: https://scratcher.io/fr/help/developers/rest-api language: fr --- 1. [Centre d’aide](https://scratcher.io/fr/help) 2. [API, webhooks et MCP](https://scratcher.io/fr/help/developers) 3. Bien démarrer avec l’API REST # Bien démarrer avec l’API REST Créez un jeton d’accès, choisissez les portées et lisez les campagnes, les leads et les listes depuis vos propres systèmes. L’API REST de Scratcher permet à vos propres systèmes de lire vos campagnes, vos leads et vos listes, d’ajouter et de mettre à jour des leads, et de gérer des produits. Cet article s’adresse au développeur chargé de la mise en place. L’API est incluse à partir du forfait Basic. ## Créer un jeton d’accès 1. Allez dans **Paramètres** > **API** (sous **Développeurs**). 2. Sous **Jetons d’accès personnels**, cliquez sur **Créer un jeton d’accès personnel**. 3. Donnez-lui un **Nom**, comme « Entrepôt de données », et choisissez les **Portées** dont il a besoin. Ne lui donnez que les accès nécessaires. 4. Cliquez sur **Enregistrer** et copiez le jeton sous **Secret**. Il ne s’affiche qu’une seule fois : conservez-le en lieu sûr, par exemple dans un gestionnaire de mots de passe. Un jeton appartient à votre utilisateur et donne accès à tous les comptes dont vous êtes membre. Pour retirer l’accès, ouvrez le jeton et cliquez sur **Révoquer**. ## Portées - `read:campaigns` : lire les campagnes - `read:lists` : lire les listes de leads - `read:leads` et `write:leads` : lire, créer, mettre à jour et supprimer des leads - `read:placements` et `write:placements` : lire et gérer les placements - `read:products` et `write:products` : lire et gérer les produits ## Envoyer une requête L’URL de base est `https://platform.scratcher.io/api/v1/`. Envoyez le jeton dans l’en-tête `Authorization` : ```text curl https://platform.scratcher.io/api/v1/accounts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Accept: application/json" ``` ## Principaux endpoints - `GET /me` : l’utilisateur auquel appartient le jeton - `GET /accounts` : les comptes auxquels vous avez accès - `GET /accounts/{account}/campaigns` et `/campaigns/{campaign}` : vos campagnes - `GET /accounts/{account}/campaigns/{campaign}/leads` : les leads d’une campagne, avec les lots, les codes et les consentements accordés - `GET /accounts/{account}/lists` et `/lists/{list}/leads` : les listes de leads et leurs leads, ainsi que `POST`, `PUT` et `DELETE` pour gérer les leads - `/accounts/{account}/products` : les produits - `/accounts/{account}/placements` : les placements Les résultats sont paginés avec `?page=`. La limite est de 60 requêtes par minute et par utilisateur. La référence complète, avec des exemples et une collection Postman, se trouve dans la [documentation de référence de l’API](https://platform.scratcher.io/docs/index.html). Le bouton **Référence de l’API** de la plateforme y renvoie aussi. ## Applications OAuth Si vous développez une application à laquelle d’autres utilisateurs de Scratcher se connectent, enregistrez-la sous **Mes apps** > **Créer une app** avec un **Nom de l’application** et une **URI de redirection**. Vous obtenez un **ID client** et un **Secret client**. Le secret ne s’affiche qu’une seule fois. Les applications que les gens ont approuvées sont listées sous **Apps autorisées**, où leur accès peut être révoqué. API, webhooks et MCP - [Bien démarrer avec l’API REST](https://scratcher.io/fr/help/developers/rest-api) - [Envoyer des données vers vos systèmes avec les webhooks](https://scratcher.io/fr/help/developers/webhooks) - [Le MCP Scratcher pour vos propres outils IA](https://scratcher.io/fr/help/developers/mcp) ## Articles associés - [Envoyer des données vers vos systèmes avec les webhooks](https://scratcher.io/fr/help/developers/webhooks): Recevez une requête sur votre propre URL quand quelqu’un s’inscrit ou gagne, avec un payload signé et un journal de chaque livraison. - [Le MCP Scratcher pour vos propres outils IA](https://scratcher.io/fr/help/developers/mcp): Bientôt, vous pourrez connecter Claude, ChatGPT et d’autres outils IA à Scratcher grâce au MCP. Voici ce que nous savons pour l’instant. - [Connecter plus de 8 000 applications avec Zapier](https://scratcher.io/fr/help/integrations/zapier): Envoyez les nouveaux inscrits de Scratcher vers Google Sheets, Slack, votre CRM ou des milliers d’autres applications avec Zapier. ## Besoin d’aide supplémentaire ? De vraies personnes sont là pour vous aider. Si vous utilisez déjà Scratcher, le plus rapide est le chat dans la plateforme. - **[Discutez avec nous](https://platform.scratcher.io/login)** Connectez-vous et cliquez sur le bouton de chat en bas à droite. Rex répond immédiatement, et notre équipe est à un clic. - **[Prenez rendez-vous](https://scratcher.io/fr/book-a-meeting)** Un appel vidéo gratuit de 30 minutes avec notre équipe : une démonstration, des idées de campagnes ou de l’aide pour votre configuration. - **[Écrivez-nous](mailto:contact@scratcher.io)** Écrivez à contact@scratcher.io et nous vous répondrons.