Limites de requêtes de l'API
Ce que restreint la limite de requêtes
Une limite de requêtes surveille la fréquence à laquelle votre application peut appeler l'API — c'est-à-dire le nombre de requêtes, et non le nombre de messages envoyés. Le portail le signale directement dans les réglages :
La définition de cette limite limite le nombre de requêtes API, et non le nombre de messages envoyés. Lorsque la limite est atteinte, l'API renvoie le code HTTP
429 Too Many Requestset les messages ne sont pas acceptés.
Une seule requête peut contenir des centaines de messages ; cette limite protège donc autre chose que les limites de messages de l'API — elle surveille le rythme de vos appels, et non le volume que vous envoyez.
Lorsque la limite est épuisée, l'API rejette la requête entière. Les messages qu'elle contient ne sont enregistrés nulle part et ne sont pas envoyés plus tard — contrairement à la limite de messages, où ceux au-delà de la limite suivent l'action au-delà des limites définie.
Où trouver la limite
- Dans le menu du portail, cliquez sur
Modules et API - Sous
Mes API et modules, cliquez sur la carte de votre application - Restez sur l'onglet
Réglageset faites défiler jusqu'à la partieLimites de l'API
La carte Limites des requêtes API affiche les valeurs sur deux lignes —
Nombre maximal de requêtes par minute et Nombre maximal de requêtes par seconde.
Tant que rien n'est défini, elle affiche Vous n'avez aucun paramètre. et un
bouton Configurer.
Comment définir la limite
Le bouton Configurer (ou Modifier, si vous avez déjà une limite) ouvre la
fenêtre Limites des requêtes API avec deux options indépendantes :
| Option | Ce qu'elle définit |
|---|---|
Activer la limite de requêtes API par minute |
Le nombre de requêtes que l'application peut envoyer en une minute |
Activer la limite de requêtes API par seconde |
Le nombre de requêtes que l'application peut envoyer en une seconde |
Cocher une option fait apparaître le champ Entrez le nombre de demandes. Vous
pouvez activer l'une ou l'autre, ou les deux à la fois.
Deux règles encadrent la configuration :
- la plus petite valeur acceptée est
1— sinon le portail vous avertit parMinimum value is 1 - si vous activez les deux options, la limite par seconde ne doit pas être
supérieure à la limite par minute ; sinon vous obtenez
La valeur ne doit pas dépasser les requêtes par minute
Le bouton Enregistrer reste désactivé tant que les deux règles ne sont pas
respectées — et aussi tant que vous n'avez pas modifié les valeurs par rapport à
celles déjà enregistrées.
Comment la limite est comptée
Le compteur est lié à la seconde et à la minute calendaires, et non à une fenêtre glissante. Dès qu'une nouvelle seconde commence (une nouvelle minute pour la limite par minute), le compteur repart de zéro.
La limite par seconde est utile pour lisser les pics, la limite par minute pour le rythme global. Si vous définissez les deux, elles s'appliquent ensemble — une requête ne passe que si elle respecte les deux.
Comment supprimer la limite
La flèche à côté du bouton Modifier ouvre un menu avec l'option Effacer. La
fenêtre de confirmation Supprimer les limites des requêtes API demande
Êtes-vous sûr de vouloir supprimer les limites de requêtes API ? — une fois la
suppression confirmée, l'API ne restreint plus le rythme de vos appels.
Merci pour votre retour.