Guides Editors API Reference
Aide
Documentation

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 notre API dans une période de temps donnée. Ces limites sont mises en place pour prévenir les abus, assurer une utilisation équitable et maintenir les performances globales de l'API. Par défaut, notre API a une limite de 60 requêtes par minute.

Limites spécifiques aux points de terminaison

Chaque point de terminaison de notre API peut avoir sa propre limite spécifique, en fonction de sa complexité et de sa consommation de ressources. Sauf indication contraire, les points de terminaison suivent la limite par défaut de 60 requêtes par minute. Consultez la documentation de chaque point de terminaison pour vérifier s'il existe des limites différentes.

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 "429 Too Many Requests" 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é.