API v1

API REST QualiForma

Intégrez votre LMS dans vos outils existants. Catalogue, inscriptions, paiements, Qualiopi, webhooks — tout est disponible via une API REST cohérente.

Commencer API Reference

Premier appel en 30 secondes

Authentifiez-vous et obtenez votre access token.

import requests

response = requests.post(
    'https://api.qualiforma.site/api/v1/auth/login',
    headers={'X-Tenant-ID': 'votre-tenant'},
    json={'email': 'admin@example.com', 'password': '...'}
)
tokens = response.json()['data']
access_token = tokens['accessToken']
print(f"Token obtenu : {access_token[:30]}...")

curl -X POST https://api.qualiforma.site/api/v1/auth/login \
  -H 'X-Tenant-ID: votre-tenant' \
  -H 'Content-Type: application/json' \
  -d '{"email": "admin@example.com", "password": "..."}'

# Réponse :
# {
#   "data": {
#     "accessToken": "eyJhbGci...",
#     "refreshToken": "eyJhbGci...",
#     "expiresIn": 3600
#   },
#   "meta": { "timestamp": "2026-01-01T00:00:00Z" }
# }

const response = await fetch('https://api.qualiforma.site/api/v1/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Tenant-ID': 'votre-tenant',
  },
  body: JSON.stringify({ email: 'admin@example.com', password: '...' }),
});

const { data } = await response.json();
const accessToken = data.accessToken;
// accessToken = "eyJhbGci..."

Explorer la documentation

Commencer ici
Quickstart
Faites votre premier appel API en moins de 5 minutes. Login, profil, formations et inscriptions.
Authentification
JWT access + refresh tokens, multi-tenancy via X-Tenant-ID, OIDC headless pour SSO.
Formations
CRUD complet : lister, créer, publier, mettre à jour et supprimer des formations.
Webhooks
Recevez des événements temps-réel (inscription, paiement, publication) avec vérification HMAC.
API Reference
Swagger UI interactif + Scalar pour explorer tous les endpoints avec des exemples live.
Bientôt
SDK (à venir)
Client TypeScript et Python en cours de développement. Abonnez-vous pour être notifié.

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)

Bases de l'API

Paramètres techniques de base de l'API REST QualiForma v1
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

API REST QualiForma

Premier appel en 30 secondes

Explorer la documentation

Quickstart

Authentification

Formations

Webhooks

API Reference

SDK (à venir)

Avant de commencer

Bases de l'API