Ressources

Codes d'erreur

Vue d'ensemble

Otonum utilise des codes de statut HTTP standard et un corps de réponse d'erreur cohérent. Vérifiez toujours le code de statut et analysez le corps d'erreur pour gérer correctement les échecs.

Format des réponses d'erreur

Code
{
  "error": "CODE_ERREUR",
  "errorMessage": {
    "fr": "Description en francais.",
    "en": "Description en anglais"
  }
}

Codes de statut HTTP

Statut	Signification	Quand ça se produit	Action
200	OK	Requête réussie	Traiter la réponse
400	Bad Request	JSON malformé ou champ requis manquant	Corriger le payload de la requête
401	Unauthorized	Clé API manquante ou invalide	Vérifier l'en-tête x-api-secret
403	Forbidden	Clé valide mais permissions insuffisantes, ou restriction sandbox	Vérifier l'environnement et l'opération
404	Not Found	Membre, bon ou ressource introuvable	Vérifier l'identifiant
409	Conflict	reference en double	Ne pas resoumettre. L'activité est déjà enregistrée
422	Unprocessable Entity	Erreur de validation dans le corps de la requête	Lire le message d'erreur pour le champ spécifique
429	Too Many Requests	Limite de débit dépassée (10 req/s par clé API)	Relancer avec backoff exponentiel
500	Internal Server Error	Erreur serveur inattendue	Relancer une fois ; contacter le support si persistant

Codes d'erreur

Authentification

Code	Description
UNAUTHORIZED	Clé API manquante ou invalide
FORBIDDEN	La clé n'a pas accès à cette ressource

Membre

Code	Description
CUSTOMER_NOT_FOUND	Aucun Membre trouvé avec le code personnel ou l'email fourni
CUSTOMER_ALREADY_EXISTS	Un Membre avec cet email ou ce téléphone est déjà inscrit
CONSENT_REQUIRED	La requête d'enrollment manque d'informations de consentement
INVALID_POLICY_VERSION	La version de politique de consentement fournie ne correspond pas à la version actuelle

Transactions & Activités

Code	Description
DUPLICATE_REFERENCE	Une activité avec cette reference existe déjà
VOUCHER_NOT_FOUND	Le redemptionCode ne correspond à aucun bon actif
VOUCHER_ALREADY_CONSUMED	Le bon référencé a déjà été utilisé
VOUCHER_EXPIRED	Le bon référencé a dépassé sa date d'expiration
VOUCHER_NOT_RESERVED	Tentative de rachat d'un bon sans réservation préalable

Bons d'achat

Code	Description
INSUFFICIENT_BALANCE	Le solde du Membre est inférieur au seuil minimum de remboursement
VOUCHER_CREATION_DISABLED	La création de bons n'est pas disponible dans cet environnement (sandbox)

Limitation de débit

Code	Description
RATE_LIMIT_EXCEEDED	La limite de 10 requêtes/seconde par clé API est atteinte

Points importants

• Un 409 Conflict sur un achat ne signifie pas que l'achat a échoué. cela signifie qu'il a déjà été traité avec succès. Ne resoumettre pas.
• Dans l'environnement sandbox, les opérations sur les bons retournent 403 par conception. Consultez Authentification pour les détails du sandbox.

Voir aussi

• Bonnes pratiques. Limitation de débit, nouvelles tentatives et gestion des erreurs
• Authentification. Configuration de la clé API et des environnements