Surveiller les clés API : journaux et utilisation
Inspectez les journaux de requêtes de l'API développeur et les statistiques d'utilisation — nombre de requêtes par clé et par route, taux d'erreur et latence — pour déboguer vos intégrations et repérer les abus.
- 1
Ce que vous pouvez surveiller
Les requêtes de chaque clé API Developer : nombres par clé et par route, taux d'erreur, latence, et journaux de requêtes individuelles avec identifiants de requête.
- 2
Ouvrir Settings → API
La section API comporte trois onglets : API Keys, Logs, et Usage. Cette section est réservée aux admins/propriétaires — les autres rôles voient un message indiquant que la gestion des clés est restreinte.
- 3
Lire l'onglet Usage
Des totaux sur une fenêtre glissante (par défaut 7 jours) : nombre total de requêtes et taux d'erreur global, puis une répartition par clé et par route pour voir quelle clé ou quel endpoint génère du trafic et des erreurs.
- 4
Approfondir dans l'onglet Logs
Chaque ligne de requête affiche la méthode, le schéma de route, le statut HTTP, la latence (ms), le préfixe de clé à l'origine de la requête, un code d'erreur (le cas échéant), et un identifiant de requête pour le support.
- 5
Déboguer une intégration défaillante
Parcourez les Logs à la recherche de valeurs
statushors 2xx, lisez leerrorCode, et faites correspondre lekeyPrefixà la clé responsable. Citez lerequestIdlorsque vous contactez le support. - 6
Repérer un abus ou un script emballé
Un pic de requêtes d'une seule clé dans la répartition by key, ou un taux d'erreur qui grimpe dans Usage, est votre signal pour révoquer cette clé dans l'onglet API Keys et en réémettre une correctement délimitée en portée.
Astuces de pro
Des raccourcis chèrement acquis pour garder le préchauffage sur la bonne voie.
Commencez par Usage, puis descendez dans Logs
Utilisez Usage pour voir l'ampleur du problème — quelle clé, quelle route, à quel point — puis passez à Logs pour les requêtes individuelles en échec. Une approche descendante est plus rapide que de parcourir des logs bruts.
L'identifiant de requête est ce dont le support a besoin
Copiez l'identifiant de requête d'une ligne de log en échec plutôt que de décrire « une erreur 500 plus tôt aujourd'hui » — c'est le moyen le plus rapide d'obtenir de l'aide.
Vérifiez les scopes avant d'accuser l'API
Un taux d'erreur croissant sur une clé signifie généralement une hypothèse périmée dans cette intégration (champ renommé, scope révoqué) — vérifiez d'abord les scopes de cette clé.
Vérifiez le rôle avant de déboguer un accès
Seuls les admins/propriétaires voient cette section ; si un coéquipier « ne trouve pas les logs API », vérifiez son rôle avant de supposer un problème.
Questions fréquentes
FirstSales expose-t-il les logs des requêtes API ?
Oui — Settings → API → Logs affiche, par requête, la méthode, la route, le statut, la latence, le préfixe de clé, le code d'erreur, et un identifiant de requête.
Où voir à quel point mes clés sont utilisées ?
L'onglet Usage : requêtes totales, taux d'erreur, et répartitions par clé et par route sur une fenêtre glissante (7 jours par défaut).
Qui peut consulter les logs et l'usage de l'API ?
Uniquement les admins et propriétaires de l'organisation. Les autres rôles voient un message indiquant que la gestion des clés est réservée aux admins/propriétaires.
Comment déboguer un appel API en échec ?
Dans Logs, trouvez la requête via un statut hors 2xx, lisez son errorCode, notez le keyPrefix et le requestId, et partagez cet identifiant avec le support.
Une clé semble compromise — que faire ?
Révoquez-la dans l'onglet API Keys et émettez-en une nouvelle avec uniquement les scopes nécessaires ; surveillez les comptages par clé dans Usage pour confirmer que le trafic s'arrête.
Puis-je changer la fenêtre d'usage ?
La vue Usage utilise par défaut les 7 derniers jours. Utilisez l'onglet Logs (avec ses filtres) pour une inspection plus fine, requête par requête.
Prêt à passer à la pratique ?
Démarrez votre essai FirstSales et lancez une boîte mail préchauffée et authentifiée en quelques minutes.
Commencer pour 1 $