Guides

Surveillez l'utilisation de votre clé avant d'atteindre une limite

Découvrir que vous approchez de votre limite quotidienne parce qu'une requête vient d'être rejetée est la manière la moins utile de l'apprendre. Chaque réponse contient déjà les chiffres nécessaires pour le voir venir.

Les en-têtes à surveiller

X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Z

X-Quota-Free-Remaining qui diminue vers zéro est votre signal d'alerte le plus clair pour le quota quotidien gratuit. X-Credits-Remaining vous indique la marge restante une fois le quota gratuit dépassé, lorsque vous puisez dans le crédit prépayé à 0,0001 € par requête.

Définir votre propre seuil d'alerte

Plutôt que d'attendre une 429, journalisez ou déclenchez une alerte dès que X-Quota-Free-Remaining passe sous un seuil de votre choix, par exemple 10 pour cent de X-Quota-Limit, afin d'avoir le temps de réagir, qu'il s'agisse de ralentir une tâche par lots, de recharger du crédit ou simplement de prévoir une période creuse jusqu'à X-Quota-Reset.

Surveiller aussi les emplacements IP de la clé

X-Key-IPs-Used et X-Key-IPs-Limit indiquent combien d'adresses source différentes ont utilisé une clé donnée dans le cadre de son quota glissant d'emplacements IP. Une clé soudainement utilisée depuis plus d'adresses que prévu, qui se rapproche de sa limite, mérite une enquête à part entière, indépendamment du volume de requêtes, car cela peut indiquer qu'une clé est partagée plus largement que prévu.

Construire un tableau de bord simple

Un petit script qui journalise ces en-têtes sur un échantillon de requêtes, ou sur chaque requête si le volume est assez faible, vous donne une tendance d'utilisation dans le temps sans nécessiter d'appel de surveillance distinct, puisque les chiffres arrivent avec des réponses que vous obteniez déjà. Tracer X-Quota-Used en fonction du temps sur une journée ou une semaine fait apparaître des schémas d'utilisation qu'un instantané unique ne montrerait jamais.

Agir avant de heurter le mur

Dès que vous constatez que vous frôlez régulièrement votre limite, les deux voies possibles sont les mêmes deux options disponibles à tout moment : ajouter du crédit prépayé pour les dépassements occasionnels, ou passer à une clé Unlimited à 50 € par mois si vous dépassez régulièrement le quota gratuit. Chacune de ces décisions est plus facile à prendre sereinement, à l'avance, qu'en réaction à une 429 en direct qui bloque du trafic réel.

Lire les en-têtes de quota comme une télémétrie de routine, et pas seulement comme quelque chose à vérifier quand une requête échoue, transforme une limite stricte en une tendance maîtrisable. Le quota actuel et les options de crédit figurent sur la page des tarifs, et les définitions complètes des en-têtes dans la documentation sur les limites de débit.