Limiter les appels et régler la conservation du journal
Fixer le nombre de requêtes autorisées par minute et par clé, et la durée de conservation du journal des appels
À quoi ça sert
Deux réglages gouvernent l'usage de l'API publique dans votre organisation : combien de requêtes une clé API peut faire par minute, et combien de temps le journal de ses appels est conservé.
Le premier protège l'application contre un outil tiers mal configuré qui enchaînerait les appels. Le second arbitre entre la profondeur du suivi et le volume de données conservées.
Les deux se règlent depuis « Administration », « Modules », sur le module « API publique ». Ils valent pour toute l'organisation.
Concepts clés
- Limite de requêtes par minute, par clé — le nombre maximum de requêtes qu'une clé API peut faire en une minute. La limite est comptée par clé, pas par organisation : chaque clé a son propre quota.
- Rétention du journal des appels — le nombre de jours pendant lesquels un appel reste visible dans l'onglet « Activité » d'une clé, avant purge automatique.
Comment faire
Ouvrir les réglages du module API
- Dans le menu, ouvrez « Administration », puis « Modules ».
- Sur la ligne du module « API publique », cliquez sur l'icône de la colonne « Actions ».
- Dans le volet, ouvrez l'onglet « Paramètres ».
Si vous n'êtes pas administrateur du module API, l'onglet affiche « Seuls les administrateurs du module API peuvent modifier ces paramètres. » Voir Activer et configurer les modules.
Modifier la limite de requêtes par minute
- Ouvrez l'onglet « Paramètres » du module API.
- Renseignez « Limite de requêtes par minute, par clé ». La valeur va de 1 à 600.
- Cliquez sur « Enregistrer ».
Le message « Paramètres de l'API mis à jour » confirme. En cas d'échec : « Impossible d'enregistrer les paramètres de l'API ». Le bouton reste indisponible tant qu'aucune valeur n'a changé.
Modifier la durée de conservation du journal des appels
- Ouvrez l'onglet « Paramètres » du module API.
- Renseignez « Rétention du journal des appels (jours) ». La valeur va de 1 à 365.
- Cliquez sur « Enregistrer ».
Raccourcir la rétention supprime définitivement, lors de la prochaine purge, les appels plus anciens que la nouvelle durée.
Référence
Réglages
| Réglage | Minimum | Maximum | Valeur par défaut |
|---|---|---|---|
| Limite de requêtes par minute, par clé | 1 | 600 | 60 |
| Rétention du journal des appels (jours) | 1 | 365 | 30 |
Questions fréquentes
Que se passe-t-il quand une clé dépasse sa limite de requêtes ?
Ses appels suivants sont refusés jusqu'à ce que la minute en cours se termine, sans affecter les autres clés.
La limite s'applique-t-elle à toutes les clés à la fois ?
Non. Chaque clé a son propre quota, indépendant des autres clés de l'organisation.