Comment gérer les clés d’API de votre compte

Découvrez comment accéder aux clés d’API de votre compte Klaviyo et les gérer.

Pour en savoir plus sur la création ou le clonage d’une clé d’API privée, lisez comment créer des clés d’API privées.

Différence entre clés d’API publiques et privées

Votre clé d’API publique est également appelée « Identifiant de site ». C’est une valeur alphanumérique courte. Cette clé publique est un identifiant unique pour votre compte Klaviyo, et il n’y en a qu’une par compte. Vous pouvez inclure votre clé d’API publique dans le code de votre site web. Elle n’accorde pas l’autorisation de lire les données privées du compte.

Les clés d’API privées permettent aux applications de lire ou de modifier les données de votre compte Klaviyo, comme les listes, selon les autorisations (scopes) que vous sélectionnez. Traitez les clés d’API privées comme des mots de passe : conservez-les en lieu sûr et ne les divulguez jamais au public. Un compte Klaviyo peut générer autant de clés d’API privées que nécessaire.

Que faire si votre clé d’API privée a été exposée ?

Votre clé d’API publique est destinée à être utilisée dans le code d’un site web public. Elle ne permet pas à quelqu’un de lire les données privées du compte, mais elle peut être utilisée pour envoyer des données via des API client, telles que des événements et des mises à jour de profils.

Gardez les clés d’API privées confidentielles. Une personne disposant d’une clé privée peut utiliser ses autorisations pour afficher ou modifier les données clients.

Si une clé d’API privée est exposée, supprimez-la immédiatement, puis créez une nouvelle clé d’API privée. Mettez à jour chaque application qui utilisait la clé exposée pour qu’elle utilise la nouvelle clé. N’accordez à la clé de remplacement que les autorisations dont l’application a besoin, et utilisez une clé d’API privée différente pour chaque application.

Trouver vos clés d’API

1. Cliquez sur le nom de votre compte dans la partie inférieure gauche.
2. Cliquez sur Paramètres.

3. Sélectionnez l’onglet Clés d’API .
4. Affichez votre clé d’API publique (ID du site).
5. Sous Clés d’API privées, examinez les noms des clés et les niveaux d’accès. Vous pouvez identifier une clé grâce à ses 4 derniers caractères, mais vous ne pouvez pas afficher ni copier la clé complète ici.

Si une clé ne se trouve pas dans l’onglet Actif, vérifiez Inactif ou Désactivé si ces onglets sont affichés.

Cloner des clés d’API privées

Lorsque vous clonez des clés d’API privées existantes, la clé clonée :

• Utilisez une clé entièrement différente de la clé d’origine.
• Utilisez le même nom que l’original.
• Avoir les mêmes scopes que l’original, à l’exception des scopes obsolètes qui ne sont plus pris en charge.

Le clonage laisse la clé d’origine en place. Copiez ou téléchargez la clé clonée, puis stockez-la de manière sécurisée. Pour l’utiliser dans une application, mettez à jour les paramètres de cette application avec la nouvelle clé. Supprimez la clé d’origine lorsqu’elle n’est plus nécessaire.

Supprimer une clé d’API privée

La suppression d’une clé d’API privée est irréversible. Les requêtes API qui l’utilisent ne fonctionneront plus. Si vous remplacez une clé qui n’a pas été exposée, mettez à jour et testez les applications qui l’utilisent avant de la supprimer. Si la clé est exposée, supprimez-la immédiatement.

1. Ouvrez l’onglet clés d’API en suivant les étapes ci-dessus. Sous Clés d’API privées, trouvez la clé que vous souhaitez supprimer.
2. Ouvrez le menu à 3 points à côté de la clé, puis sélectionnez Supprimer.
3. Cliquez sur Supprimer dans la boîte de dialogue de confirmation.

Ressources supplémentaires