Créer et gérer des clés API

Les clés API vous permettent d'interagir avec Middlewr de manière programmatique : créer des liens, consulter les analytics ou gérer votre espace de travail via l'API. Chaque clé possède un niveau de permissions qui détermine ce à quoi elle donne accès. Ce guide couvre la création, l'utilisation et la suppression des clés API.

Prérequis

• Un compte Middlewr
• Le rôle Admin sur l'espace de travail (la gestion des clés API est réservée aux administrateurs)

Étape 1 : Accéder aux clés API

Rendez-vous dans Paramètres depuis la barre latérale, puis cliquez sur l'onglet Clés API. Cette page liste toutes les clés API existantes de l'espace de travail, avec leur nom, préfixe, niveau de permissions, date de dernière utilisation et date de création.

Si aucune clé n'existe encore, un état vide vous invite à créer votre première clé.

Étape 2 : Créer une clé API

Cliquez sur Créer une clé API. Une fenêtre modale apparaît avec deux champs :

1. Nom — un libellé descriptif pour identifier cette clé (par exemple « Pipeline CI/CD », « Automatisation marketing »).
2. Permissions — sélectionnez le niveau de permissions pour cette clé dans le menu déroulant. Les niveaux disponibles dépendent de votre propre rôle : vous ne pouvez accorder que des permissions égales ou inférieures aux vôtres.

Cliquez sur Créer pour générer la clé.

Étape 3 : Copier votre clé

Après la création, une boîte de dialogue affiche votre clé API complète. C'est la seule fois où la clé est visible — copiez-la immédiatement et stockez-la en lieu sûr (gestionnaire de secrets, variable d'environnement, etc.).

Le préfixe de la clé (premiers caractères suivis de ...) restera visible dans le tableau pour l'identification, mais la clé complète ne pourra plus être récupérée.

Supprimer une clé API

Pour supprimer une clé, cliquez sur le bouton de suppression à côté de celle-ci dans le tableau. Une boîte de dialogue de confirmation vous demandera de valider, en précisant que toute application utilisant cette clé perdra immédiatement son accès. Cette action est irréversible.

Bonnes pratiques de sécurité

• Une clé par intégration — ne partagez pas une même clé entre plusieurs services. Si l'une est compromise, vous pouvez la révoquer sans impacter les autres.
• Permissions minimales — n'accordez à chaque clé que le niveau d'accès dont elle a réellement besoin.
• Surveillez l'utilisation — la colonne « Dernière utilisation » vous aide à repérer les clés inactives à supprimer.
• Renouvelez régulièrement — créez une nouvelle clé, mettez à jour votre intégration, puis supprimez l'ancienne.

Pour aller plus loin

Maintenant que vos clés API sont en place, voici quelques pistes à explorer :

• Importer et exporter des liens en CSV — gérez vos liens en masse en important ou exportant via des fichiers CSV, ce qui se combine bien avec des workflows pilotés par API.
• Gérer la facturation et les forfaits — mettez à niveau votre espace de travail pour débloquer des limites de taux API plus élevées et des fonctionnalités supplémentaires à mesure que votre utilisation augmente.
• A/B testing avec le split routing — combinez la création de liens par API avec le split routing pour automatiser vos workflows de tests A/B.