Concepts

Format des requêtes

Vue d'ensemble

Toutes les requêtes et réponses de l'API Otonum utilisent le format JSON. L'API suit les conventions REST standard avec des codes de statut HTTP prévisibles.

En-tête Content-Type

Définissez toujours l'en-tête Content-Type sur les requêtes POST et PUT :

Code
Content-Type: application/json

Format des dates

Les dates sont représentées au format ISO 8601, fuseau horaire UTC :

Code
2026-05-22T14:32:00Z

Pour filtrer par plages de dates, utilisez le même format ISO 8601 pour les paramètres de requête.

Montants monétaires

Les montants monétaires sont représentés sous forme de nombres décimaux avec jusqu'à 2 décimales, dans la devise configurée pour votre compte tenant :

Marché	Devise
Canada	CAD
Côte d'Ivoire	XOF
France	EUR

Code
{
  "amount": 89.99,
  "redemptionAmount": 10.0
}

Versionnement de l'API

Tous les endpoints sont préfixés par la version de l'API. Pour éviter tout décalage, consultez la Référence API pour la route canonique de chaque opération.

Lorsqu'une nouvelle version est publiée, la version précédente reste disponible pendant une période de dépréciation. Consultez le Journal des changements pour rester informé.

Format des réponses d'erreur

Toutes les réponses d'erreur suivent une structure cohérente :

Code
{
  "error": "CODE_ERREUR",
  "errorMessage":{
    "fr":"Description en francais.",
    "en":"Description en englais"
  },
  "httpStatus": "STATUS_CODE" 
}

Consultez Codes d'erreur pour la liste complète des codes d'erreur et des actions recommandées.

Voir aussi

• Authentification. En-tête de clé API
• Bonnes pratiques. Limitation de débit et idempotence
• Codes d'erreur. Référence complète des codes d'erreur