Usage
Ce que la page Usage de Platform montre pour chaque produit : deux registres séparés, ce que chacun compte, et ce qu'un zéro ou une lecture indisponible veut dire.
La page Usage a deux sections, une par produit, qui lisent deux registres différents. Elles ne se mélangent jamais : aucune requête Transaction Intelligence n'entre dans un compteur Merchant API, et inversement. Ce que vous lisez ici est une visibilité d'usage, pas une facture : ce qui est facturé se lit sur la page Facturation. Voir Facturation.
Merchant API
La section couvre les trente derniers jours de l'espace de travail. Un tableau donne, pour chaque jour :
| Colonne | Ce qu'elle compte |
|---|---|
| appels | Les appels réglés ce jour-là |
| unités | Les unités portées par ces appels |
| resolved, partial, not_found | Les appels selon leur résultat |
| engine_error | Les pannes du moteur, jamais facturées |
| 429 | Les appels limités en débit |
| refresh | Les appels de rafraîchissement |
Sous ce tableau, Appels récents liste les cinquante derniers appels : request_id, date, enrichment_id, résultat, type d'appel et unités. Pour désigner un appel auprès du support, citez son request_id. Ni libellé, ni identifiant de transaction n'y figurent.
Les latences et les codes HTTP ne figurent pas dans cette section : son registre ne porte que les appels réglés. Un appel refusé avant d'être réglé n'y laisse aucune ligne.
La page Vue d'ensemble montre aussi, pour Merchant API, les unités consommées et restantes de la dotation Sandbox, et les appels des trente derniers jours par résultat. Voir Sandbox et Observabilité.
Transaction Intelligence
Tant que le sandbox Transaction Intelligence n'est pas activé pour l'espace de travail, la section le dit : il n'y a rien à compter. L'activation se fait sur la page Clés d'API. Voir Clés d'API.
Une fois le sandbox activé, la section compte chaque requête authentifiée de l'espace, avec le statut HTTP réellement rendu : total, succès (2xx), erreurs client (4xx hors 429), limitées (429, ventilées par clé et par espace) et erreurs serveur (5xx). Elle se lit sur 24 heures, 7 jours ou 30 jours, par jour UTC et par clé ; cliquer sur une clé filtre la section sur elle. Une requête sans clé valide (401), une clé révoquée et GET /openapi.json ne sont jamais comptées.
La section rappelle aussi la limite de débit du sandbox, par clé et par espace de travail : c'est une protection opérationnelle, ni un quota, ni un crédit. Le détail des familles d'opérations, de la rétention et des jours « non observés » est sur Usage et clés d'API ; les limites, sur Limites de débit.
Zéro, indisponible, plancher
La section Transaction Intelligence distingue trois situations :
- Zéro : la lecture a réussi et n'a trouvé aucune requête. C'est une mesure.
- Indisponible : la lecture du registre a échoué. La section n'affiche alors aucun zéro, elle écrit « usage indisponible ». Rechargez la page ; si cela persiste, contactez le support.
- Plancher : si une clé a servi après la dernière requête consignée, la section prévient que le registre a manqué des requêtes. Ses nombres sont alors un minimum, pas une mesure exacte.
Pour aller plus loin
- Clés d'API : créer, filtrer, révoquer.
- Facturation : ce qui est facturé, et ce qui ne l'est pas.
- Facturation de Merchant API : ce qu'un appel coûte en production.
Publié le 2026-10-09 10:17 UTC (version 1).