Documentation API QualiForma
API REST conforme OpenAPI 3.1 — 763+ endpoints, authentification Bearer JWT, multi-tenant, conforme Qualiopi. 18 modules documentés, exemples en Python, TypeScript, PHP et cURL.
Commencer en 60 secondes
Listez vos formations avec un access token et le slug tenant — tout le reste suit le même pattern.
Catalogue par domaine
21 pages organisées en 5 catégories : démarrage, référence interactive et 18 modules métier répartis en 3 thématiques.
Démarrage & Référence
Trois entrées rapides pour faire ton premier appel et explorer la spec complète.
Cœur LMS
5 endpointsGestion des tenants, utilisateurs, formations, inscriptions et sessions live.
Tenants
Multi-tenancy, gestion plateforme, branding, paramètres d'organisme de formation.
Utilisateurs
CRUD utilisateurs, rôles (ADMIN/CREATOR/LEARNER), profils, préférences.
Formations
Catalogue, création, publication, modules et leçons, documents, formateurs.
Inscriptions
Inscrire des apprenants, suivre progression, complétion, certifications.
Sessions live
Sessions LiveKit, planning, convocations, enregistrements, transcriptions.
Conformité Qualiopi
10 endpointsCouverture complète des 32 indicateurs Qualiopi (audit, BPF, plans, médiateurs).
Dashboard Qualiopi
32 indicateurs Qualiopi, dashboard, export ZIP audit complet.
Conformité
Analyse des besoins, validation publication, timeline PAF.
Émargement
Présence numérique, 4 méthodes de signature (canvas, code, QR, biométrie).
Questionnaires
Pré/post-formation, satisfaction, analyse IA des réponses.
Réclamations
Gestion des réclamations apprenants (Critère 6 Qualiopi).
Plans d'amélioration
Plans d'amélioration continue (Critère 7 Qualiopi).
Parcours adaptatifs
Parcours personnalisés par apprenant (skip / reorder / extra IA).
Compétences formateurs
Référentiel des compétences formateurs (Critère 5 Qualiopi).
BPF
Bilan Pédagogique et Financier — live + export annuel.
Médiateurs
Médiateurs de la consommation (obligation légale).
Paiements & Facturation
3 endpointsEncaissements multi-PSP, facturation Factur-X conforme et webhooks signés.
Référence API interactive
ScalarExplorez les 763+ endpoints documentés avec exemples live, schemas OpenAPI 3.1 et console de test intégrée. Navigation rapide, recherche full-text et copie en un clic dans 4 langages.
Ouvrir la référencePremier appel API détaillé
Authentifiez-vous et obtenez votre access token dans 4 langages.
Standards respectés
L'API QualiForma respecte les standards industriels d'authentification, de spécification et de conformité réglementaire.
OpenAPI 3.1
Spec auto-générée + générateurs SDK compatibles
JWT Bearer (OAuth 2.0)
Access + refresh tokens, rotation à chaque refresh
Multi-tenant
Header X-Tenant-ID obligatoire sur toutes les requêtes
Rate limiting
1000 req/h par token + throttling par endpoint
Webhooks HMAC-SHA256
Signature par tenant + secret unique par webhook
WCAG 2.1 AA
Dashboards et docs accessibles, navigation clavier complète
RGPD compliant
Droit à l'oubli, export, audit trail, chiffrement au repos
Qualiopi conforme
32 indicateurs couverts par API + export audit ZIP
SDKs & langages supportés
Tous les exemples de la documentation sont disponibles dans 4 langages. Les SDKs packagés arrivent au S2 2026.
cURL
DisponibleTous les exemples sont disponibles en cURL — copier/coller direct.
Python
Exemples dispoExemples avec requests + httpx — SDK officiel en cours de packaging.
TypeScript / JavaScript
Exemples dispoExemples fetch natif — SDK @qualiforma/sdk planifié H2 2026.
PHP
Exemples dispoExemples Guzzle — SDK Composer planifié H2 2026.
Avant de commencer
- Un compte QualiForma avec un tenant configuré
- Votre slug tenant (ex. : mon-organisme-formation)
- Des identifiants admin ou créateur
- Un client HTTP : curl, requests (Python), fetch (JS), Guzzle (PHP)
Bases de l'API
| Paramètre | Valeur |
|---|---|
| URL de base | https://api.qualiforma.site/api/v1 |
| Format de réponse | JSON — { data: T, meta: { timestamp, requestId } } |
| Authentification | Bearer token dans Authorization header |
| Multi-tenant | Header X-Tenant-ID obligatoire sur toutes les requêtes |
| Versioning | Préfixe /api/v1 — breaking changes = nouvelle version |
| Rate limiting | 1000 requêtes / heure par token |
Liens utiles
Spec OpenAPI, Swagger UI classique, status page, support développeurs et CGV.
- (s'ouvre dans un nouvel onglet)
OpenAPI 3.1 (JSON)
Spec OpenAPI complète — 763+ endpoints documentés.
- (s'ouvre dans un nouvel onglet)
Swagger UI
Interface Swagger classique pour explorer l'API.
API Reference (Scalar)
Interface Scalar moderne avec exemples live.
- (s'ouvre dans un nouvel onglet)
Status page
Disponibilité de l'API en temps réel + historique d'incidents.
- (s'ouvre dans un nouvel onglet)
Support développeurs
Une question technique ? Écrivez-nous à developers@qualiforma.site
CGV
Conditions générales de vente, SLA et politique d'usage de l'API.