Erreurs

Format d’erreur JSON renvoyé par l’API.

Format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Idempotency-Key header required",
    "details": {}
  }
}

Code	Signification
`UNAUTHORIZED` / `INVALID_API_KEY`	Clé ou session invalide
`FORBIDDEN` / `CAPABILITY_DENIED`	Droit ou capability insuffisant
`VALIDATION_ERROR`	Corps / header manquant ou invalide
`IDEMPOTENCY_CONFLICT`	Même clé, payload différent
`IDEMPOTENCY_IN_PROGRESS`	Requête concurrente
`PROVIDER_UNAVAILABLE`	Opérateurs non configurés (souvent Production), ou MVola momentanément injoignable
`PROVIDER_RATE_LIMITED`	Quota MVola atteint ; `details.retryAfter` indique quand réessayer s’il est connu
`PROVIDER_REJECTED`	MVola a refusé la demande (`details.providerErrorCode`)
`PROVIDER_AUTH_FAILED` / `MVOLA_PRODUCTION_NOT_CONFIGURED`	Connexion MVola refusée ou configuration MVola incomplète
`PROVIDER_OUTCOME_UNKNOWN`	MVola n’a pas confirmé la demande : ne pas relancer, vérifier le statut
`CSRF_FAILED`	Token CSRF manquant / invalide (session)
`RATE_LIMITED`	Trop de requêtes (auth / compliance)