Limites et quotas
Pour assurer un fonctionnement optimal de notre API, nous avons mis en place des limites et des quotas. Ce guide vous aidera à comprendre comment fonctionnent les limites et les quotas, et comment les gérer.
Limites
Les limites définissent le nombre maximum de requêtes qu'un utilisateur peut effectuer sur une période de temps donnée. Les limites aident à gérer l'utilisation à court terme et à prévenir l'utilisation excessive.
Limites spécifiques aux points de terminaison
Chaque point de terminaison de notre API peut avoir ses propres limites. Vérifiez la documentation de chaque point de terminaison pour déterminer la limite associée.
Headers liés aux limites
Lorsque vous effectuez une requête à un point de terminaison, nous incluons des en-têtes dans la réponse pour vous aider à surveiller votre utilisation des limites. Les en-têtes suivants sont inclus dans chaque réponse:
- X-RateLimit-Limit: Affiche le nombre maximum de requêtes que vous pouvez effectuer dans la fenêtre de temps actuelle.
- X-RateLimit-Remaining: Affiche le nombre de requêtes restantes que vous pouvez effectuer dans la fenêtre de temps actuelle.
Dépassement de la limite
Lorsque vous atteignez la limite de requêtes, toute requête supplémentaire à ce point de terminaison entraînera une erreur "403 Forbidden" jusqu'à ce que la nouvelle fenêtre de temps commence.
Quotas
Les quotas définissent le nombre maximum de requêtes qu'un utilisateur peut effectuer sur une période de temps donnée. Les quotas aident à gérer l'utilisation à long terme et à prévenir l'utilisation excessive.
Quotas spécifiques aux points de terminaison
Chaque point de terminaison de notre API peut avoir ses propres quotas. Vérifiez la documentation de chaque point de terminaison pour déterminer le quota associé.
Monitorer les quotas
Lorsque vous effectuez des requêtes à notre API, nous mettons à jour votre utilisation des quotas dans le backend. Vous pouvez surveiller votre consommation de quotas via le tableau de bord de l'API ou en vérifiant les en-têtes spécifiques dans les réponses de l'API.
Dépassement du quota
Lorsque vous atteignez le quota de requêtes, toute requête supplémentaire à ce point de terminaison entraînera une erreur "403 Forbidden" jusqu'à ce que le quota soit réinitialisé.