Comprendre les quotas et limites de l’API
| Limite par défaut | Valeur |
|---|---|
| Organisme, toutes intégrations réunies | 100 requêtes admises par jour UTC |
| Organisme, fenêtre glissante | 60 requêtes sur 60 secondes |
| Intégration | Plafond organisme ou limite inférieure |
| Corps JSON | 262144 octets |
| Apprenants par demande entreprise | 1 à 100, éventuellement moins selon le paramétrage |
| Requêtes métier simultanées | 2 par organisme |
| Intégrations actives | 10 par organisme |
Une requête peut contenir plusieurs apprenants : 100 requêtes ne signifient pas 100 apprenants. Après admission, les erreurs de permission/validation, réutilisations et réessais idempotents consomment le quota. L’authentification invalide et les rejets précoces du serveur ne consomment pas le quota quotidien. Un quota quotidien déjà épuisé n’augmente pas lors des nouveaux refus. Une défaillance temporaire après réservation peut consommer une tentative. Les réservations de débit sont conservatrices : un refus ultérieur peut avoir occupé une place sur la fenêtre de 60 secondes.
En-têtes : X-VF-School-Daily-Limit, X-VF-School-Daily-Remaining, X-VF-Integration-Daily-Limit, X-VF-Integration-Daily-Remaining, X-VF-Daily-Reset. Un dépassement renvoie 429 et Retry-After en secondes. Pour le quota quotidien, le délai va jusqu’au prochain 00:00 UTC, pas simplement une minute. Les plafonds peuvent être ajustés par l’opérateur.
Après 20 échecs d’authentification depuis une même adresse IP sur dix minutes, cette IP est bloquée trente minutes. Ce mécanisme ne révoque pas l’intégration ni l’organisme ciblé. Les réseaux partagés demandent une attention particulière ; contactez le support pour un blocage persistant.