Surveillez l'utilisation de votre clé avant d'atteindre une limite
Surveiller vos en-têtes de quota au fil de l'eau vous indique quand une limite approche, bien avant qu'une requête ne soit effectivement refusée.
Construire une intégration implique généralement des dizaines ou des centaines d'appels de test avant que quoi que ce soit n'approche du trafic de production, et aucun de ces tests n'a besoin de passer par une offre payante.
2 500 requêtes gratuites par jour sont disponibles depuis n'importe quelle adresse sans aucune clé, ce qui suffit pour l'essentiel du travail d'intégration : mettre en place le format des requêtes, vérifier l'analyse des réponses et parcourir la gestion des erreurs sur quelques cas de test chacun.
GET /v1/forward?q=Test Address, Test City&limit=1Pas d'en-tête X-API-Key, pas d'en-tête Authorization, rien d'autre que la requête elle-même.
Même sans clé, chaque réponse comporte les mêmes en-têtes de quota : vous pouvez donc voir X-Quota-Used et X-Quota-Free-Remaining monter et descendre exactement comme en production, ce qui est utile pour tester la façon dont votre propre code gère ces en-têtes avant que cela compte pour de vrai.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458Une fois inscrit et votre clé générée, cette clé dispose aussi de ses propres 2 500 requêtes gratuites par jour, un espace de test distinct qui ne touche pas au crédit prépayé et ne compte pas dans un forfait Unlimited. C'est le moment de tester le comportement propre à la clé, comme les différentes façons de l'envoyer (en-tête, jeton bearer, authentification basic ou paramètre de requête), le tout sans rien dépenser.
Envoyez une requête avec un paramètre invalide pour voir une erreur 400, ou une clé volontairement erronée pour voir une erreur 401, afin que votre code de gestion des erreurs ait réellement été exercé avant le lancement au lieu d'être supposé fonctionnel. Chacun de ces appels de test, réussi ou non, compte pour une requête dans le quota gratuit, ce qui ne devrait pas vous inquiéter aux volumes de test habituels.
Une fois le trafic réel lancé, le même quota gratuit continue de couvrir l'usage quotidien typique de nombreuses petites intégrations, le crédit prépayé ou un forfait Unlimited ne devenant nécessaires qu'au-delà de 2 500 requêtes par jour.
Aucun environnement sandbox distinct n'est nécessaire ici, puisque le quota gratuit offre déjà un terrain de test complet avec la véritable API. Commencez par générer une clé depuis le tableau de bord, ou lisez d'abord la documentation sur l'authentification si vous voulez voir les formats de clé avant de vous inscrire.