## 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 Requests` et 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](https://www.bulkgate.com/fr/documentation/administration-api-et-tokens/limites-api/) —
elle surveille le rythme de vos appels, et non le volume que vous envoyez.

> [!IMPORTANT]
> 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

1. Dans le menu du portail, cliquez sur `Modules et API`
2. Sous `Mes API et modules`, cliquez sur la carte de votre application
3. Restez sur l'onglet `Réglages` et faites défiler jusqu'à la partie `Limites 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`.

![La carte Limites des requêtes API dans le détail de l'application](docs:api-request-limits/request-limit-card_en)

## 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.

![La fenêtre avec les réglages de la limite de requêtes](docs:api-request-limits/request-limit-settings_en)

Deux règles encadrent la configuration :

- la plus petite valeur acceptée est `1` — sinon le portail vous avertit par
  `Minimum 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.

> [!TIP]
> 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.