VisioFormation · APIConnecter vos outils, conserver le contrôle

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.