La plupart des API vous laissent deviner où vous en êtes de votre utilisation jusqu'à ce que quelque chose casse. My Geocode adopte une approche différente : chaque réponse, sur chaque endpoint et chaque hôte de compatibilité, comporte un ensemble complet d'en-têtes de quota qui vous indiquent exactement où vous en êtes.
X-Quota-Limit et X-Quota-Used donnent la vue d'ensemble pour la clé ou le réseau appelant. X-Quota-Free-Remaining indique ce qu'il reste du quota gratuit quotidien, et X-Quota-Network-Used reflète la part de ce quota gratuit partagé par réseau déjà consommée par toute adresse ou clé sur la même connexion. X-Credits-Remaining indique le solde de crédit prépayé pour ceux qui ont dépassé l'offre gratuite sans disposer d'un forfait Unlimited. X-Key-IPs-Used et X-Key-IPs-Limit suivent le nombre d'adresses distinctes depuis lesquelles une clé donnée a été utilisée, et X-Quota-Reset vous indique quand les compteurs quotidiens sont remis à zéro.
La raison pour laquelle c'est important est simple : un script qui voit son propre quota peut se comporter intelligemment en conséquence. Il peut ralentir avant d'être bloqué, alerter un développeur lorsque le crédit s'épuise, ou passer automatiquement d'une clé gratuite à une clé payante au lieu d'échouer d'abord et de réagir ensuite. Rien de tout cela ne nécessite d'appeler un endpoint d'utilisation séparé ni de consulter un tableau de bord à la main. L'information accompagne la réponse que vous avez déjà demandée.
C'est vrai que vous utilisiez nos endpoints natifs ou l'un des dix-sept hôtes de compatibilité. Une requête au format d'un appel à Google Maps Platform, Bing Maps REST Services ou ipstack revient toujours avec nos en-têtes de quota, en plus du corps de réponse correspondant au format de ce fournisseur. Changer de fournisseur ne signifie pas perdre cette visibilité, cela signifie la gagner là où elle n'avait jamais existé.
Chaque clé dispose d'un quota gratuit quotidien. Au-delà, les requêtes sont décomptées du crédit prépayé ou couvertes par un forfait Unlimited. Chaque réponse vous indique où vous en êtes dans ses en-têtes, ce qui est un détail sur un appel isolé et un véritable atout sur une journée de trafic chargée.
Pour les équipes qui développent autre chose qu'un script ponctuel, nous vous conseillons d'enregistrer ces en-têtes avec vos propres journaux de requêtes dès le départ. Une tendance discrète de X-Quota-Free-Remaining qui baisse plus vite que prévu coûte beaucoup moins cher à repérer sur un graphique que dans un ticket d'assistance. Tous les détails sur chaque en-tête et ce qui le déclenche sont documentés sur /docs/rate-limits/, avec des conseils généraux sur l'authentification sur /docs/authentication/.