Documentation - Documentation

Clé API

Incluez votre clé API dans l'en-tête de la requête

En-tête HTTP requis:

X-API-Key: your_api_key_here

Exemple de Requête

Voici des exemples de requêtes authentifiées dans différents langages :

curl -X GET "https://api.currencyrest.com/v1/rates?base=USD" \
  -H "X-API-Key: your_api_key_here"

Exemple de réponse

200 OKjson

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00Z",
  "base": "USD",
  "rates": {
    "EUR": 0.92,
    "GBP": 0.79,
    "JPY": 148.50,
    "BTC": 0.000023,
    "ETH": 0.00038
  }
}

Obtenir votre clé API

Créez un compte gratuit sur CurrencyRest
Accédez à votre tableau de bord
Allez dans la section "Clés API"
Cliquez sur "Créer une clé API"

Bonnes pratiques de sécurité

Ne jamais exposer votre clé

Ne partagez jamais votre clé API publiquement ou dans le code source versionné

Utiliser des variables d'environnement

Stockez vos clés API dans des variables d'environnement, jamais en dur dans le code

Révoquer les clés compromises

Si vous pensez qu'une clé est compromise, révoquez-la immédiatement depuis votre dashboard

HTTPS uniquement

Toutes les requêtes doivent être effectuées via HTTPS. HTTP n'est pas supporté

Codes d'erreur d'authentification

401 Unauthorized - Missing API Key

{
  "error": {
    "code": "unauthorized",
    "message": "API key is missing",
    "type": "authentication_error"
  }
}

401 Unauthorized - Invalid API Key

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid",
    "type": "authentication_error"
  }
}

Authentification