À propos des clés API

Dans cet article, nous allons vous expliquer ce qu'est une API, ainsi que comment générer une clé API pour octroyer l'accès à votre compte Mailchimp. Nous vous indiquerons également où trouver de l'aide en cas de questions sur l' API marketing Mailchimp.

Cet article fait uniquement référence aux clés API pour l' API Marketing Mailchimp. Pour en savoir plus sur l' API opérationelle Mailchimp, consultez le guide de démarrage rapide de l'API opération.

Qu'est-ce qu'une API ?

L'API est pour interface de programmation d'application. Considérez une API comme un moyen pour différentes applications de communiquer entre elles. Vous envoyez et recevez des données entre des applications à l'aide de requêtes et réponses API. Une clé API est une série unique de caractères incluse dans une demande afin de vérifier que le système demandeur est autorisé à communiquer avec le système destinataire.

Générer une clé API

Vous devrez souvent générer une clé API pour l'intégration dans votre compte Mailchimp. Les utilisateurs disposant des droits d'accès de gestionnaire peuvent créer leurs propres clés API. Les utilisateurs avec des droits d'administrateur peuvent également voir les clés API que d'autres utilisateurs du compte ont générées.

Vous ne pourrez voir la clé API complète qu'une fois que vous l'avez générée. Ensuite, vous ne verrez que le nom que vous avez donné et ses 4 premiers chiffres.

Pour générer une clé API, suivez les étapes ci-dessous.

1. Cliquez sur l'icône de votre profil et sélectionnez Profil.
2. Cliquez sur la liste déroulante Extras , puis sélectionnez Clés API.
3. Dans la section Vos clés API, cliquez sur Créer une clé.
4. Donnez un nom à votre clé. Soyez descriptif, pour que vous sachiez quelle appli utilise cette clé. Gardez à l'esprit que vous ne verrez que ce nom et les 4 premiers chiffres de votre liste de clés API.
5. Cliquez sur Générer la clé.
6. Une fois que nous avons généré votre clé, cliquez sur Copier la clé dans le presse-papiers. Enregistrez votre clé en toute sécurité, vous ne pourrez plus la voir ni la copier. Si vous perdez cette clé, vous devrez en créer une nouvelle et mettre à jour les intégrations qui l'utilisent.
7. Cliquez sur Terminer.

Renvoyer une clé API

Si une clé d'API a été compromise, ou si vous n'utilisez plus l'intégration qui vous aidait à accéder à votre compte, vous pouvez supprimer cette clé d'API. La réactivation d'une clé API n'est plus disponible. Vous devrez générer une nouvelle clé et mettre à jour les intégrations qui utilisent la clé d'origine.

Pour révoquer une clé API, suivez les étapes ci-dessous.

1. Cliquez sur l'icône de votre profil et sélectionnez Profil.
2. Cliquez sur la liste déroulante Extras , puis sélectionnez Clés API.
3. Trouvez la clé API que vous voulez annuler et cliquez sur Annuler.
4. Dans la fenêtre modale, entrez « RE Rev », puis cliquez sur Rapprocher pour confirmer votre action.

sécurité des clés API

Les clés API vous accordent un accès complet à votre compte Mailchimp. Veillez à les protéger de la même manière que vous protégez votre mot de passe. Gardez à l'esprit les scénarios courants lorsque vous utilisez des clés API.

• Donnez à chaque intégration sa propre clé API. Attribuez un nom descriptif à chaque clé pour savoir quelle clé est associée à quelle appli. Si une clé d'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, des vidéos ou des documents d'aide). N'oubliez pas qu'il ne suffit pas de supprimer vos données. Il est préférable de supprimer ces données complètement.
• En raison des risques de sécurité liés à l'affichage des clés API des comptes, Mailchimp ne prend pas en charge l'implémentation côté client de notre API via les requêtes CRS ou n'inclut pas les clés API dans les applis mobiles.
• Si vous devez partager l'accès à votre compte, créez une nouvelle clé et nommez-la pour savoir quelle clé supprimer, si nécessaire. Ne envoyez jamais de clé API par e-mail. Celle-ci pourrait permettre l'accès à votre compte Mailchimp si des tentatives d'accès à votre compte de messagerie électronique.
• Si vous supprimez 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é d'API détermine l'accès à chaque point de terminaison. Pour en savoir plus sur les autorisations relatives aux utilisateurs, consultez la page Gérer les niveaux d'utilisateurs dans Votre compte.

Prise en charge de l'API

Notre équipe de soutien technique Mailchimp n'est pas formée pour le dépannage de l'API. Si vous avez besoin d'aide d'un développeur pour configurer quelque chose à l'aide de l'API, consultez notre très bon répertoire d'experts. Cette liste liste les experts Mailchimp tiers qui peuvent être contactés pour obtenir de l'aide.

Si vous êtes un développeur et souhaitez compléter votre propre intégration avec Mailchimp, consultez notre documentation sur l'API.