Documentation

Limites de débit

Afin de garantir une utilisation équitable et la stabilité du système, notre API met en œuvre une limitation de débit. Les différents forfaits d'abonnement ont des limites de débit différentes.

Volumes inclus par offre

Votre volume mensuel dépend de votre offre. C'est un quota commun à tous les produits, et chaque appel facturé y compte une fois.

Free : 30 000 requêtes par mois, soit environ 1 000 par jour en moyenne, sans plafond journalier.

Offres payantes : Starter 150 000, Pro 500 000 et Business 2 000 000 requêtes par mois. Enterprise est illimité.

Point de terminaison de démonstration : Le point de terminaison de démonstration, sans clé, autorise environ 100 requêtes par jour et par adresse IP, sans inscription.

GET /v1/demo/{ip}

En-têtes de limite de débit

Toutes les réponses de l'API incluent des en-têtes qui fournissent des informations sur l'état actuel de votre limite de débit :

X-RateLimit-Limit: Nombre maximal de requêtes autorisées dans la fenêtre temporelle actuelle

X-RateLimit-Remaining: Nombre de requêtes restantes dans la fenêtre temporelle actuelle

X-RateLimit-Reset: Heure de réinitialisation de la fenêtre de limite de débit (horodatage Unix)

Limite de débit dépassée

Si vous dépassez votre limite de débit, l'API renverra une réponse 429 Too Many Requests avec le corps suivant :

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

Bonnes pratiques

Mettez en œuvre un délai d'attente : Lorsque vous recevez une erreur de limite de débit, mettez en œuvre un délai d'attente exponentiel avant de réessayer.

Mettez les réponses en cache : Mettez en cache les réponses de l'API lorsque cela est possible pour réduire le nombre de requêtes.