PrevenAPIVersion de la spécification
Version courante : 2026-02, d'après les quatre guides officiels « Préparer ses fichiers pour l'alimentation en masse » datés du 27/02/2026 et les deux trames CSV publiées sur le portail d'information du Passeport de prévention.
Où la voir
GET /v1/spec: colonnes, obligations, conditions, énumérations et état des référentiels, lisibles par une machine. Sans authentification.- Chaque réponse de validation ou de génération porte
spec_version. - Le téléchargement d'un fichier porte l'en-tête
X-Spec-Version.
Quand le format officiel change
Une nouvelle version est ajoutée (2027-01 par exemple) et devient la version par défaut. L'ancienne reste utilisable en envoyant "spec_version": "2026-02", le temps de migrer. Un changement de version par défaut est annoncé à l'avance par e-mail aux comptes actifs.
Référentiels
Les codes sont contrôlés contre les quatre listes publiées en open data par la Caisse des Dépôts, opérateur du Passeport :
| Référentiel | Colonne | GET /v1/reference/… |
|---|---|---|
| Formacodes santé et sécurité au travail | DOMAINE_FORMATION |
formacodes/{code} |
| Codes NSF | SPECIALITE_FORMATION |
nsf/{code} |
| Compétences transférables ROME | COMPETENCE_TRANSFERABLE |
rome-skills/{code} |
| Certifications RS | CERTIFICATION_VISEE |
certifications/{code} |
Ils sont copiés localement et rafraîchis chaque nuit : aucune requête externe n'a lieu pendant votre appel. Si un référentiel n'est pas chargé, l'API répond 503 REFERENCE_SERVICE_UNAVAILABLE plutôt que de valider à l'aveugle.
Une incertitude assumée
Les guides parlent d'un « contrôle de l'existence des codes dans le référentiel » sans préciser s'il s'agit de ces listes SST ou des référentiels nationaux complets. Par défaut nous refusons un code absent des listes SST. Si vous constatez que le portail accepte un code que nous refusons, passez strict_references: false (le refus devient un avertissement) et écrivez-nous.