Diagnostiquer les erreurs HTTP de l’API
201 indique une création ; 200 une réutilisation compatible sans nouvelle ressource ou un contrôle de connexion. Une pré-inscription enregistrée renvoie 201 et pending_validation, sans inscription immédiate. Les demandes entreprise sont atomiques, sans succès partiel. L’API n’ajoute ni envoi automatique d’email ni paiement comme effet par défaut ; des automatisations déjà configurées dans votre application peuvent observer les nouveaux enregistrements.
{
"success": false,
"request_id": "req_0123456789abcdef0123456789abcdef",
"error": {
"code": "VALIDATION_ERROR",
"message": "Certaines informations sont invalides.",
"fields": {
"students[0].email": "Adresse email invalide."
}
}
}
| HTTP | Signification |
|---|---|
| 400 | Requête JSON/en-têtes invalides |
| 401 | Authentification invalide |
| 403 | Permission, accès, abonnement ou IP non autorisés |
| 404 | Référence introuvable ou indisponible pour cet organisme |
| 405 | Méthode non autorisée |
| 409 | Conflit d’identité, contrat ou idempotence ; opération en cours |
| 413 | Corps trop volumineux |
| 415 | Type de contenu non accepté |
| 422 | Champs invalides |
| 429 | Quota, débit, concurrence ou blocage temporaire |
| 500 | Erreur interne |
| 503 | Dépendance indisponible |
Transmettez uniquement le request_id au support, jamais les jetons. Pour 401, vérifiez la paire et son environnement. Pour 403, vérifiez l’abonnement, les permissions, l’état de l’intégration et la liste IP. Pour 404, contrôlez les identifiants dans votre propre organisme et le lien programme/session. Pour 409, examinez le code exact : AMBIGUOUS_STUDENT, STUDENT_IDENTITY_CONFLICT, AMBIGUOUS_COMPANY, COMPANY_IDENTITY_CONFLICT, STUDENT_EMPLOYER_CONFLICT, ENROLLMENT_CONFLICT ou IDEMPOTENCY_CONFLICT. Une référence d’un autre organisme est volontairement indiscernable d’une référence inexistante.