L’onglet Request logs du
Developer Hub affiche le trafic de l’API /v1 de votre
organisation : des statistiques récapitulatives sur les dernières 24 heures —
nombre de requêtes, taux d’erreur et requêtes soumises à une limitation de débit — au-dessus d’un
journal consultable des requêtes individuelles.
Ce que chaque entrée enregistre
Le tableau du journal indique l’heure, la méthode HTTP, le chemin, le statut de la réponse, la décision de politique, la latence et l’identifiant de requête de chaque appel. L’ouverture d’une entrée affiche
le détail complet, y compris le compte de service et la clé d’API à l’origine de l’appel,
l’adresse IP source et les autorisations en vigueur.
La décision de politique indique comment la requête a été traitée :
- Allowed — la requête a été authentifiée et autorisée.
- Denied — la requête a été refusée, par exemple parce que la clé ne disposait pas
de l’autorisation requise, avait expiré ou avait été révoquée.
- Rate limited — la requête a dépassé un quota de requêtes et a été refusée
avec un code
429. Consultez les limites de débit.
Filtrer et rechercher
Affinez le journal par compte de service, clé d’API, méthode HTTP, classe de statut
(2xx–5xx), décision de politique, plage de temps ou préfixe de chemin (par exemple
/v1/entities).
Retrouver une erreur grâce à l’identifiant de requête
Chaque réponse de l’API contient un en-tête Request-Id, et chaque corps d’erreur
contient la même valeur dans son champ request_id. Collez cette valeur dans la recherche du
journal de requêtes pour accéder directement à l’entrée correspondante et voir précisément
comment la requête a été traitée.
Lorsqu’une intégration signale une erreur, demandez le request_id figurant dans la
réponse d’erreur. C’est le moyen le plus rapide de passer d’un symptôme côté client à
l’enregistrement de référence de ce qui s’est produit — et la valeur à communiquer si vous
contactez le support de Living Security.
Repérer rapidement les problèmes
- Une hausse du taux d’erreur signifie généralement qu’une clé a expiré, a été révoquée ou a perdu
une autorisation nécessaire — filtrez par décision pour identifier l’identifiant défaillant.
- Une hausse du nombre de requêtes soumises à une limitation de débit indique qu’une charge de travail est trop intensive ; consultez les
limites de débit pour connaître les stratégies de lissage.
- Le trafic d’un compte de service qui devrait être inactif est un signal qui doit vous amener à vérifier
si ses identifiants se trouvent bien là où vous le pensez — et à
désactiver le compte pendant
votre investigation.