Guides
Limites de débit
Les requêtes sont limitées par clé API, et chaque réponse authentifiée vous indique où vous en êtes.
La limite
La valeur par défaut est de 600 requêtes par minute, mesurées sur une fenêtre de 60 secondes. Les comptes disposant d’un débit convenu plus élevé peuvent se voir attribuer une limite différente sur des clés individuelles.
La limite s’applique par clé, pas par compte. C’est délibéré : cela veut dire que renouveler une clé ou en ajouter une pour un second service ne divise pas par deux le débit de ce que vous faites déjà tourner.
Les en-têtes
Chaque réponse authentifiée porte votre position actuelle, pas seulement celles qui sont refusées — vous pouvez donc lever le pied avant d’être refusé plutôt qu’après.
La valeur de réinitialisation est un horodatage Unix absolu en secondes, pas un nombre de secondes à attendre. Comparez-la à votre propre horloge plutôt que de la traiter comme un délai.
Le document OpenAPI est servi en dehors du chemin authentifié et ne porte aucun en-tête de limite de débit.
Quand vous la dépassez
Dépasser la limite renvoie un 429 avec un Retry-After en secondes. L’erreur est marquée comme réessayable ; attendez le délai indiqué plutôt que de recommencer immédiatement.
Deux limites différentes
Il existe deux limites indépendantes et elles mesurent des choses différentes. La limite par clé compte les requêtes HTTP. Une limite distincte, à l’échelle du compte, compte les destinataires et s’applique à toutes les surfaces, pas seulement à l’API.
La limite de requêtes est vérifiée avant toute analyse : un 429 ne vous coûte donc rien — il ne consomme aucun quota de destinataires de votre compte et ne réserve aucun montant.
La limite de destinataires fonctionne autrement : elle ne refuse pas la requête. Les destinataires au-delà du plafond sont retirés d’un lot par ailleurs accepté et signalés dans rejections avec un code de raison de limite de débit, ce qui est une raison de plus de lire ce tableau plutôt que de se fier au code de statut.