VisioFormation · APIConnecter vos outils, conserver le contrôle

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.