À propos des clés API

Dans cet article, nous aborderons ce qu'est une API et comment générer une clé API pour accorder l'accès à votre compte Mailchimp. Nous verrons également où vous adresser pour obtenir de l'aide concernant l'API Mailchimp Marketing.

Qu'est-ce qu'une API ?

"API" est l'acronyme de Application Programming Interface, qui signifie interface de programmation applicative. Il s'agit d'un moyen de communication entre différentes applications. Vous envoyez et recevez des données entre les applications à l'aide de requêtes et de réponses API. Une clé API est une série unique de caractères qui est incluse dans une demande pour vérifier que le système demandeur est autorisé à communiquer avec le système récepteur.

Générer une clé API

Vous devrez souvent générer une clé API lorsque vous configurerez une intégration avec votre compte Mailchimp. 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. Cliquez sur votre icône de profil et sélectionnez Profile (Profil).
2. Cliquez sur le menu déroulant Extras , puis sélectionnez Clés API.
3. Dans la section Vos clés API, cliquez sur Créer une clé.
4. Nommez votre clé. Soyez précis, afin de savoir quelle application utilise cette clé. N'oubliez pas que vous ne verrez que ce nom et les quatre premiers chiffres de la clé dans votre liste de clés API.
5. Cliquez sur Generate Key (Générer la clé).
6. 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.
7. Cliquez sur Done (Terminé).

Révoquer une clé API

Si une clé API est compromise, ou si vous n'utilisez plus l'intégration permettant d'accéder à votre compte via une clé API, 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 qui utilisent la clé d'origine.

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

1. Cliquez sur votre icône de profil et sélectionnez Profile (Profil).
2. Cliquez sur le menu déroulant Extras , puis sélectionnez Clés API.
3. Trouvez la clé API que vous souhaitez révoquer et cliquez sur Revoke (Révoquer).
4. Dans la fenêtre contextuelle modale, saisissez le mot SUPPRIMER , puis cliquez sur Supprimer pour confirmer votre action.

Sécurité des clés API

Les clés API vous donnent un accès complet à votre compte Mailchimp. Vous devez les protéger de la même manière que vous le feriez pour votre mot de passe. Gardez ces scénarios courants à l'esprit lorsque vous travaillez avec des clés API.

• Donnez à chaque intégration sa propre clé API. Attribuez des noms descriptifs à chaque clé afin de savoir quelle clé va avec quelle application. Si une clé API est compromise, vous pouvez la révoquer sans désactiver l'accès à vos autres intégrations.
• Veillez à ne pas exposer la clé au public (par exemple dans des captures d'écran, vidéos ou documents d'aide). Un simple floutage des données ne suffit pas toujours. Il est préférable de supprimer complètement les données.
• 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 vous avez besoin de partager l'accès à votre compte, générez une nouvelle clé et nommez-la afin de savoir quelle clé révoquer, le cas échéant. N'envoyez jamais de clé API par e-mail. Cela donnerait l'accès à votre compte Mailchimp si des hackers venaient à compromettre votre compte e-mail.
• Si vous révoquez l'accès d'un utilisateur à votre compte Mailchimp, nous supprimerons toutes les clés API que l'utilisateur a générées à partir de votre compte.
• Le rôle de l'utilisateur qui a généré la clé API détermine l'accès à chaque point final. Pour en savoir plus sur les niveaux d'autorisation utilisateur, consultez l'article Gérer les niveaux d'utilisateurs de votre compte.

Assistance pour les API

Notre service d'assistance Mailchimp ne dispose pas 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 excellent annuaire d'experts. Celui-ci liste les experts tiers de Mailchimp pouvant être contactés.

Si vous êtes développeur et que vous souhaitez construire votre propre intégration avec Mailchimp, consultez notre documentation d'API.