Documentation API XChange

Documentation complète avec endpoints, exemples de succès, erreurs et codes HTTP colorés.

Démarrage rapide

1. Créez un compte
2. Générez une clé API depuis le dashboard
3. Appelez les endpoints avec X-API-Key

Authentification

Ajoutez votre clé API dans le header X-API-Key pour chaque requête. Ouvrir le dashboard

GET /api/rates?base=USD
X-API-Key: xc_live_...

Endpoints

Derniers taux

Récupère les taux les plus récents pour une devise de base.

GET/api/rates?base=USD

Exemple de succès

{
  "base": "USD",
  "timestamp": "2026-02-26T09:00:00.000Z",
  "rates": {
    "EUR": 0.92,
    "XOF": 603.5,
    "NGN": 1498.2
  }
}

Exemple d'erreur

{
  "statusCode": 400,
  "message": "Devise de base invalide",
  "error": "Bad Request"
}

Conversion directe

Convertit un montant entre deux devises avec le taux actuel.

POST/api/conversion/convert

Exemple de succès

{
  "from": "USD",
  "to": "EUR",
  "amount": 100,
  "rate": 0.92,
  "result": 92,
  "timestamp": "2026-02-26T09:01:00.000Z"
}

Exemple d'erreur

{
  "statusCode": 422,
  "message": "Le montant doit être supérieur à 0",
  "error": "Unprocessable Entity"
}

Devises supportées

Retourne la liste des devises disponibles.

GET/api/rates/currencies

Exemple de succès

{
  "currencies": ["USD", "EUR", "GBP", "XOF", "XAF", "NGN", "JPY"]
}

Exemple d'erreur

{
  "statusCode": 500,
  "message": "Impossible de charger la liste des devises",
  "error": "Internal Server Error"
}

Historique

Retourne les taux historiques sur une période donnée.

GET/api/rates/historical?from=USD&to=EUR&days=30

Exemple de succès

{
  "from": "USD",
  "to": "EUR",
  "days": 30,
  "series": [
    { "date": "2026-02-24", "rate": 0.919 },
    { "date": "2026-02-25", "rate": 0.921 }
  ]
}

Exemple d'erreur

{
  "statusCode": 400,
  "message": "Le paramètre days doit être entre 1 et 365",
  "error": "Bad Request"
}

Exemples de code

const API_KEY = 'votre_clé_api';
const BASE_URL = 'https://api.xchange.com/api';

const response = await fetch(`${BASE_URL}/rates?base=USD`, {
  headers: { 'X-API-Key': API_KEY }
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.message);
}

const data = await response.json();
console.log(data.rates);

Codes HTTP et signification

Code	Type	Signification
200	Succès	Requête exécutée avec succès.
201	Créé	Ressource créée avec succès.
400	Requête invalide	Paramètres invalides ou incomplets.
401	Non autorisé	Clé API manquante ou invalide.
403	Interdit	Clé API inactive ou accès refusé.
404	Introuvable	Endpoint ou ressource introuvable.
422	Entité invalide	Corps de requête valide syntaxiquement, mais données invalides.
429	Quota dépassé	Trop de requêtes dans la fenêtre de quota.
500	Erreur serveur	Erreur interne du serveur.

Prêt à commencer ?

Générer ma clé API →