À propos des clés API

Dans cet article, nous allons couvrir ce qu'est une API, comment utiliser une clé d'API pour accéder à votre compte Mailchimp et comment bénéficier d'une assistance si vous avez d'autres questions concernant l'API marketing de Mailchimp.

Qu'est-ce qu'un API ?

API signifie application programming interface, soit interface de programmation. On peut dire que l' est un moyen d'interaction entre les différentes applications. Pour de nombreux utilisateurs, l'interaction principale avec l'API se fera via des clés API, qui permettent à d'autres applications d'accéder à votre compte sans vous demander votre mot de passe.

Générer une clé API

Si vous voulez configurer une intégration avec votre compte Mailchimp, vous aurez probablement besoin de générer une clé API. Les utilisateurs disposant d'autorisations de niveau Gestionnaire peuvent générer leurs propres clés API. Les utilisateurs disposant d'autorisations de niveau Administrateur peuvent également visualiser les clés API générées par d'autres utilisateurs de compte.

Pour générer une clé API, procédez comme suit.

1. Accédez à la section API Keys (Clés API) de votre compte.
2. Cliquez sur Create New Key (Créer une nouvelle clé).
3. Nommez votre clé de façon descriptive, afin de savoir quelle application l'utilise. N'oubliez pas que vous ne verrez que ce nom et les 4 premiers chiffres de votre liste de clés API après la génération de la clé.
4. Cliquez sur Generate Key (Générer la clé).
5. Une fois que nous avons généré votre clé, cliquez sur Copy Key to Clipboard (Copier la clé dans le presse-papiers). Enregistrez votre clé en lieu sûr : vous ne pourrez plus la voir ni la copier. Si vous perdez cette clé, vous devrez générer une nouvelle clé et mettre à jour toute intégration qui l'utilise.
6. Cliquez sur Done (Terminé).

Révoquer une clé API

Si vous craignez qu'une clé API soit compromise, ou si vous n'utilisez plus l'intégration permettant d'accéder à votre compte via une clé API en particulier, vous pouvez révoquer cette clé API. Une fois que vous avez révoqué une clé API, elle ne peut pas être réactivée. Vous devrez générer une nouvelle clé et mettre à jour toutes les intégrations associées.

Pour révoquer une clé API, procédez comme suit.

1. Accédez à la section API Keys (Clés API) de votre compte.
2. Trouvez la clé API que vous souhaitez révoquer et cliquez sur Revoke (Révoquer).
3. Dans la fenêtre contextuelle modale, saisissez le mot REVOKE , puis cliquez sur Revoke (Révoquer) pour confirmer votre action.

Sécurité des clés API

Les clés API vous donnent un accès total à votre compte Mailchimp et doivent être protégées de la même façon que vous protégez votre mot de passe. Il existe plus précisément quelques situations courantes qu'il faut garder à l'esprit lorsque l'on travaille avec des clés API.

• Donnez à chaque intégration sa propre clé API et attribuez des étiquettes à chaque clé afin de savoir quelle application correspond à chaque clé. Si une clé API est compromise, vous pouvez la révoquer sans désactiver l'accès à toutes vos autres intégrations.
• Veillez à ne pas exposer la clé au public (par exemple dans des captures d'écran, vidéos ou documentation d'aide). Un simple floutage des données ne suffit pas toujours. Il est préférable d'utiliser les fonctions "couper" dans votre programme graphique, afin de supprimer les données de manière définitive.
• En raison des risques de sécurité potentiels associés à l'exposition des clés API des comptes, Mailchimp ne prend pas en charge l'implémentation côté client de notre API à l'aide des requêtes CORS ou des clés API dans les applications mobiles.
• Si une clé doit être partagée, générez-en une nouvelle et nommez-la en conséquence, de sorte qu'elle puisse être révoquée si nécessaire. N'envoyez jamais une clé API par e-mail, car cela donnerait l'accès à votre compte Mailchimp si des hackers pirataient votre messagerie.
• Si vous révoquez l'accès d'un utilisateur à votre compte Mailchimp, les clés API créées par l'utilisateur seront supprimées de votre compte.
• L'accès à chaque point de terminaison est déterminé par le rôle de l'utilisateur qui a généré la clé API. Pour en savoir plus sur les niveaux d'autorisation utilisateur, consultez l'article Gérer les niveaux d'utilisateurs de votre compte.

Assistance technique API

Notre équipe d'assistance technique Mailchimp ne dispose d'une formation approfondie en dépannage API. Si vous avez besoin d'un développeur pour vous aider à configurer un outil en utilisant l'API, consultez notre Annuaire d'experts, qui liste les experts tiers de Mailchimp pouvant être contactés.

Si vous êtes un développeur et que vous souhaitez construire votre propre intégration avec Mailchimp, allez, avant toute chose, consulter notre documentation API.