Codes d'erreur et référence des statuts

Guide complet des codes d'erreur de l'API Smart Money, des codes de statut HTTP et des étapes de dépannage. Comprenez les réponses d'erreur et résolvez rapidement les problèmes d'intégration.

Codes de succès 2xx

Les réponses de succès indiquent que la requête a été traitée avec succès.

Code	Statut	Signification
200	OK	La requête a réussi. Le corps de la réponse contient les données demandées.
201	Créé	La ressource a été créée avec succès. La réponse inclut la nouvelle ressource.
204	Pas de contenu	La requête a réussi mais il n'y a pas de contenu à retourner (par exemple, DELETE).

Exemple de réponse 200

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Codes d'erreur client 4xx

Les erreurs client indiquent que la requête était mal formulée ou invalide. Corrigez votre requête et réessayez.

Code	Statut	Cause
400	Requête incorrecte	Syntaxe de requête malformée. Vérifiez les paramètres de requête, les en-têtes et le corps de la requête.
401	Non autorisé	Identifiants d'authentification manquants ou invalides. Vérifiez votre clé API ou votre jeton JWT.
402	Paiement requis	Le paiement de votre abonnement a échoué. Mettez à jour les informations de facturation dans votre compte.
403	Interdit	Authentifié mais non autorisé pour cette ressource. Votre plan n'inclut pas cette fonctionnalité.
404	Non trouvé	La ressource n'existe pas. Vérifiez l'URL de l'endpoint et les paramètres.
429	Trop de requêtes	Limite de débit dépassée. Attendez avant de réessayer. Vérifiez l'en-tête Retry-After.
422	Entité non traitable	Échec de la validation. Les paramètres de la requête sont invalides ou des champs obligatoires sont manquants.

Exemples d'erreurs d'authentification

Clé API manquante (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Identifiants d'authentification non fournis.",
    "resolution": "Incluez votre clé API dans l'en-tête Authorization : Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Clé API invalide (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Clé API invalide ou expirée.",
    "resolution": "Générez une nouvelle clé API depuis votre console à https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Limitation de débit (429)

Lorsque vous dépassez votre quota API, le serveur renvoie 429 Too Many Requests. Vérifiez les en-têtes de réponse pour les informations de limitation de débit :

En-têtes HTTP

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Réponse d'erreur de limitation de débit

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Limite quotidienne de requêtes API (10) dépassée.",
    "resolution": "Passez au plan Trader (29$/mois, 400 requêtes/jour) ou Pro (79$/mois, 4 000 requêtes/jour).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Erreurs de validation (422)

Les erreurs de validation se produisent lorsque les paramètres de votre requête sont invalides ou que des champs obligatoires sont manquants.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Échec de la validation de la requête.",
    "details": [
      {
        "field": "symbol",
        "error": "Paire de trading invalide. Format attendu : BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Doit être un nombre positif"
      }
    ],
    "resolution": "Corrigez les erreurs de validation et réessayez."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Codes d'erreur serveur 5xx

Les erreurs serveur indiquent un problème de notre côté. Elles sont temporaires et se résolvent généralement rapidement. Implémentez une logique de réessai avec backoff exponentiel.

Code	Statut	Action
500	Erreur interne	Erreur serveur inattendue. Réessayez avec un backoff exponentiel.
502	Mauvaise passerelle	Interruption temporaire du service. Réessayez après quelques secondes.
503	Service indisponible	Maintenance ou interruption temporaire. Consultez la page d'état. Réessayez après l'intervalle Retry-After.
504	Délai de passerelle dépassé	La requête a pris trop de temps. Le serveur l'a peut-être traitée malgré tout. Vérifiez l'idempotence.

Exemple d'erreur serveur (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Service temporairement indisponible en raison de la maintenance.",
    "resolution": "Veuillez réessayer après 5 minutes. Suivez l'état à https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Guide de dépannage

401 Non autorisé - Clé API invalide

Problème : Recevoir des erreurs 401 même avec une clé API.

Solutions :

Vérifiez que la clé API est incluse dans l'en-tête Authorization avec le préfixe "Bearer"
Vérifiez que votre clé API n'a pas expiré ou été révoquée
Assurez-vous d'utiliser la bonne clé (production, staging ou développement)
Générez une nouvelle clé API depuis votre console si la clé actuelle est perdue

403 Interdit - Fonctionnalité non disponible

Problème : Recevoir des erreurs 403 sur certains endpoints.

Solutions :

Vérifiez votre niveau d'API. Certains endpoints nécessitent les plans Trader ou Pro
Passez à un plan supérieur sur /pricing.html pour accéder aux fonctionnalités premium
Vérifiez que la clé API a les scopes requis activés
Contactez le support si vous pensez avoir accès

429 Trop de requêtes - Limitation de débit

Problème : Recevoir des erreurs 429 et être limité.

Solutions :

Implémentez une logique de réessai avec backoff exponentiel (attendez 1s, 2s, 4s, etc.)
Mettez en cache les réponses pour éviter les appels API redondants
Utilisez WebSocket pour les données en temps réel au lieu de poller les endpoints REST
Passez à un plan supérieur pour des quotas plus élevés (Trader 1,000/jour, Pro 5 000/jour)
Regroupez plusieurs requêtes en une seule lorsque possible

400 Requête incorrecte - Paramètres invalides

Problème : Recevoir des erreurs 400 avec des requêtes malformées.

Solutions :

Consultez la documentation de l'API pour les paramètres obligatoires et optionnels
Vérifiez les types de paramètres (chaînes vs nombres, tableaux vs objets)
Assurez-vous que le JSON est valide et correctement formaté
Utilisez les URL d'endpoint correctes avec les paramètres de chemin appropriés
Vérifiez les fautes de frappe dans les noms des paramètres de requête

Erreurs serveur 5xx - Pannes temporaires

Problème : Vous obtenez des erreurs 500, 502, 503 ou 504.

Solutions :

Vérifiez l'état du service sur https://status.smartmoneyapi.com
Implémentez une nouvelle tentative automatique avec backoff exponentiel (max 5-10 tentatives)
Attendez 30-60 secondes avant de réessayer pour les erreurs 503
Utilisez l'en-tête Retry-After pour déterminer le timing de nouvelle tentative
Abonnez-vous à la page de statut pour les notifications d'incidents

Format de réponse d'erreur

Toutes les réponses d'erreur suivent un format cohérent :

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Message d'erreur lisible",
    "details": {...},
    "resolution": "Étapes pour résoudre le problème"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Besoin d'aide supplémentaire ?

Consultez notre documentation API ou contactez le support avec votre code d'erreur et les détails de la requête.

Référence API

Obtenir de l'aide

Des questions ? Consultez notre documentation ou contactez le support.

Ouvrir la console