Les limites de débit ont la réputation d'être déroutantes, pleines d'exceptions et de petites lignes qui ne deviennent claires qu'après une panne. Les nôtres sont plus simples que cela, et méritent d'être exposées clairement en un seul endroit.
Chaque adresse bénéficie de 2 500 requêtes gratuites par jour sans aucune clé. Ce quota n'est pas attribué à chaque adresse individuellement, il est partagé au sein d'un réseau : toutes les adresses IPv4 d'un même /24 et toutes les adresses IPv6 d'un même /48 puisent ensemble dans une seule réserve. Cela compte si vous êtes derrière une connexion de bureau partagée ou une importante configuration de traduction d'adresses réseau, car votre quota gratuit est partagé avec tous les autres utilisateurs de ce même segment de réseau, qu'ils utilisent une clé ou non.
Chaque clé dispose également de son propre quota gratuit quotidien de 2 500 requêtes, distinct de ce que le réseau fournit déjà. Le quota d'une clé n'est pas réduit par le reste du trafic sur le même réseau, et le quota d'un réseau n'est pas réduit par le trafic qui a déjà épuisé le quota distinct d'une clé. Les deux quotas coexistent au lieu de se faire concurrence.
Une fois les deux quotas dépassés pour la journée, une requête est soit décomptée du crédit prépayé à 0,0001 € par requête, soit couverte par un forfait Unlimited à 50 € par mois, selon ce que le compte a mis en place. Il n'y a aucune limitation qui ralentit silencieusement les requêtes, ni de blocage surprise sans explication. Chaque réponse comporte des en-têtes de quota, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit et X-Quota-Reset, de sorte que la situation exacte d'une requête est visible avant même qu'elle n'échoue.
Un appel groupé ou par lots suit les mêmes règles au niveau de l'élément, et non de l'appel. Cent adresses envoyées en un seul appel comptent comme cent requêtes sur le quota applicable, exactement comme si elles avaient été envoyées en cent appels distincts.
Tout cela s'applique de manière identique à chaque endpoint et à chacun des dix-sept hôtes de compatibilité. Une requête au format OpenCage ou ipstack est soumise exactement aux mêmes règles de limite de débit qu'une requête adressée directement à /v1/forward ou /v1/ip, sans limite distincte et plus stricte cachée derrière une forme de réponse familière.
Tous les détails, y compris le fonctionnement de la réinitialisation quotidienne et la signification de chaque en-tête, sont documentés sur /docs/rate-limits/. Si une question de limite de débit se pose un jour dans votre intégration, la réponse est presque toujours visible directement dans les en-têtes de la réponse qui l'a déclenchée.