Résoudre les problèmes - Problèmes liés aux clés API

Si vous rencontrez des problèmes avec vos clés API, tels que des échecs d’appels API, des désactivations inattendues ou des emails de sécurité, consultez les conseils suivants avant de contacter notre équipe d’assistance.

J’obtiens une erreur « Accès refusé pour la ressource »

Un appel API échoue et la réponse indique que la clé API n'inclut pas l'autorisation requise. Le message ressemble à ceci : Accès refusé pour la ressource « compte ». La clé API n'inclut pas l'autorisation requise. Mettez à jour les autorisations de la clé ou envoyez la demande avec une autre clé. Le nom de la ressource change en fonction de l'appel.

Causes et solutions courantes

Développez les accordéons suivants pour en savoir plus sur chaque cause :

La clé a un accès Restreint sans l’autorisation requise pour l’appel

La ressource nommée dans l’erreur est une ressource à laquelle la clé ne peut pas accéder ou qu’elle ne peut pas utiliser de la manière requise par l’appel. Par exemple, une clé avec l’autorisation Lecture peut voir une ressource mais ne peut pas la modifier, et la suppression nécessite Tous. Cela peut également se produire si les autorisations de la clé ont été réduites lors de sa modification.

Solution : modifiez la clé et définissez le niveau d'autorisation dont l'appel a besoin pour cette ressource. Pour en savoir plus, consultez notre article dédié Créer et gérer vos clés API. Seuls le propriétaire du compte ou les utilisateurs disposant de l'autorisation relative aux clés API peuvent modifier une clé.

Votre intégration utilise une clé différente de celle que vous attendiez

Si votre compte possède plusieurs clés API, l'intégration peut utiliser une clé dont les autorisations n'incluent pas la ressource.

Solution : comparez les derniers chiffres de la clé utilisée par votre intégration avec ceux affichés sur la page Clés API et MCP. Mettez ensuite à jour les autorisations de cette clé ou faites basculer l'intégration sur une clé disposant de l'autorisation requise.

Vérifier la correction

Envoyez à nouveau le même appel API avec la clé mise à jour et vérifiez qu’il ne renvoie plus l’erreur.

Si le problème persiste, contactez notre équipe d’assistance et incluez les derniers chiffres de la clé et le message d’erreur exact que vous avez reçu.

Ma clé API indique « Aucune date fixe », mais j’ai reçu un avertissement d’inactivité

Vous n’avez défini aucune date d’expiration lors de la création de votre clé API, mais vous avez tout de même reçu un email d’avertissement indiquant que la clé sera désactivée pour cause d’inactivité.

Cause et solution

La date d’expiration et la règle d’inactivité sont deux paramètres distincts. Aucune expiration signifie simplement que la clé n'a pas de date d'expiration fixe. Toute clé qui n’a pas effectué d’appel API réussi sous 90 jours est désactivée, quel que soit son paramètre d’expiration.

Solution : confirmez que votre intégration utilise cette clé spécifique car elle peut utiliser une clé différente de celle de votre compte. Assurez-vous ensuite qu'elle effectue au moins un appel API réussi avant la fin des 90 jours. Si la clé est déjà désactivée, vous pouvez la réactiver. Pour en savoir plus, consultez notre article dédié Créer et gérer vos clés API.

Vérifier la correction

Effectuez un appel API de test avec cette clé, puis vérifiez sur la page Clés API et MCP que son statut est Actif et que la Dernière utilisation indique la date du jour.

Si le problème persiste, contactez notre équipe d’assistance et incluez les derniers chiffres de la clé et le message d’avertissement exact que vous avez reçu.

J’ai reçu un email de sécurité « Vérifier une nouvelle adresse IP »

Vous avez reçu un email de Brevo vous demandant de confirmer ou de refuser un appel API passé à partir d’une adresse IP non reconnue et vous ne savez pas si c’est légitime ni quoi faire ensuite.

Cause et solution

Si le blocage des adresses IP inconnues est activé sur votre compte, Brevo envoie cet email chaque fois qu’il détecte un appel API provenant d’une adresse IP qui n’a pas été utilisée auparavant. Cela ne signifie pas nécessairement qu’il y a un problème. Une intégration légitime, telle qu’un nouveau serveur ou un outil tiers, peut le déclencher lorsqu’elle se connecte pour la première fois.

Solution : si vous reconnaissez l’activité, autorisez la nouvelle adresse IP depuis l’email ou depuis la page d'adresses IP autorisées. Si vous ne la reconnaissez pas, refusez-la et supprimez immédiatement la clé API concernée, puis créez-en une nouvelle. Pour en savoir plus, consultez notre article dédié Autoriser et bloquer des adresses IP pour la sécurité de l’API publique et des identifiants SMTP.

Vérifier la correction

Accédez à la page Adresses IP autorisées et vérifiez que l’adresse IP affiche le statut attendu (autorisé ou supprimé).

Si vous continuez à recevoir des alertes pour des adresses IP que vous ne reconnaissez pas après avoir remplacé votre clé API, contactez notre équipe d’assistance.

⏭️ Et après ?

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.

💬 Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 1