Documentation

RatesAPI est une API JSON permettant d'accéder aux taux de change en temps réel, mis à jour toutes les heures. Aucune authentification requise.

Base URL

https://rates.sandrindossou.com

Format de réponse

JSON
{
  "success": true,   // false si erreur
  "...":     "..."         // données spécifiques à l'endpoint
}

Codes d'erreur

Toutes les réponses incluent un champ success. En cas d'erreur, le champ error est présent avec un message et un code HTTP.

200
Succès La requête a été traitée. success: true
400
Paramètre invalide Montant invalide (ex: valeur ≤ 0).
404
Devise introuvable Le code ISO fourni n'existe pas. Vérifiez le format (ex: USD, EUR, XOF).
500
Erreur interne Problème côté serveur ou base de données inaccessible.

Format d'une réponse d'erreur

JSON — erreur
{
  "success": false,
  "error":   "Devise source introuvable: XYZ",
  "code":    404
}
GET

/api/v1/latest

/api/v1/latest?base={DEVISE}&currencies={LISTE}&amount={MONTANT}&places={DÉCIMALES}

Récupère les derniers taux de change. Par défaut, retourne tous les taux par rapport à l'USD.

Paramètres

Paramètre Type Statut Défaut Description
base String Optionnel USD Devise de base (ex: EUR, GBP)
currencies String Optionnel Toutes Liste séparée par virgules (ex: EUR,GBP,XOF)
amount Number Optionnel 1 Montant à convertir depuis la base
places Integer Optionnel 2 Décimales dans le résultat (0–8)

cURL

bash
curl "https://rates.sandrindossou.com/api/v1/latest?base=EUR&currencies=USD,XOF,NGN"

Exemple de réponse

GET /api/v1/latest?base=EUR&currencies=USD,XOF,NGN
{
  "success": true,
  "base":    "EUR",
  "rates": {
    "USD": 1.08,
    "XOF": 655.96,
    "NGN": 1728.32
  }
}

Tester

GET /api/v1/latest

        
GET

/api/v1/convert

/api/v1/convert?from={DEVISE}&to={DEVISE}&amount={MONTANT}

Convertit un montant d'une devise source vers une devise cible.

Paramètres

Paramètre Type Statut Défaut Description
from String Optionnel USD Devise source
to String Optionnel EUR Devise cible
amount Number Optionnel 1 Montant à convertir

cURL

bash
curl "https://rates.sandrindossou.com/api/v1/convert?from=USD&to=XOF&amount=100"

Exemple de réponse

GET /api/v1/convert?from=USD&to=XOF&amount=100
{
  "success": true,
  "query": {
    "from":   "USD",
    "to":     "XOF",
    "amount": 100
  },
  "result": 60550.00
}

Tester

GET /api/v1/convert

        
GET

/api/v1/currencies

/api/v1/currencies

Retourne la liste complète des devises supportées avec symboles, noms et informations de formatage. Aucun paramètre requis.

cURL

bash
curl "https://rates.sandrindossou.com/api/v1/currencies"

Exemple de réponse

GET /api/v1/currencies
{
  "success": true,
  "currencies": [
    {
      "code":           "XOF",
      "name":           "CFA Franc BCEAO",
      "symbol":         "CFA",
      "symbol_native":  "CFA",
      "decimal_digits": 0
    },
    // ... 170+ devises
  ]
}

Tester

GET /api/v1/currencies

        

Simulateur de conversion

Convertissez un montant vers plusieurs devises en une seule requête. Résultats affichés sous forme de tableau comparatif.

Conversion multi-devises

GET /api/v1/latest?base=EUR&amount=100&currencies=USD,GBP,XOF,NGN&places=4