Codes d'état HTTP

Ce document définit la spécification des codes d'état HTTP de l'API REST.

Définition des codes d'état

Code description explication
200 OK Succès !
400 Requête incorrecte La requête est invalide. La description correspondante expliquera la raison.
401 Non vérifié Aucune information de vérification ou échec de la vérification.
403 Rejeté La requête a été comprise mais non acceptée. La description correspondante expliquera la raison.
404 Introuvable La ressource n'existe pas. L'utilisateur demandé n'existe pas. Le format demandé n'est pas pris en charge.
405 Méthode de requête inappropriée L'interface ne prend pas en charge la requête pour cette méthode.
410 Hors ligne La ressource demandée est hors ligne. Veuillez consulter l'annonce correspondante.
429 Trop de requêtes La requête a dépassé la limite de fréquence. La description correspondante expliquera la raison précise.
500 Erreur interne du service Une erreur interne est survenue sur le serveur. Veuillez nous contacter pour résoudre le problème au plus vite.
502 Proxy invalide Le serveur de service est hors ligne ou en cours de mise à niveau. Veuillez réessayer plus tard.
503 Échec temporaire du service Le serveur n'a pas pu répondre à la requête. Veuillez réessayer plus tard.
504 Délai d'attente de l'agent Le serveur fonctionne, mais ne peut pas répondre à la requête. Veuillez réessayer plus tard.

Spécifications à respecter

  • 200 doit indiquer un succès. N'utilisez pas le code d'état 200 pour les exceptions.
  • Pour les erreurs de logique métier, utilisez 4xx pour les codes d'erreur spécifiques ; sinon, utilisez 400.
  • Pour les erreurs internes du serveur, si aucun code d'erreur spécifique n'est disponible, utilisez 500.
  • Lorsqu'une exception métier se produit, le contenu retourné utilise le format JSON pour définir les informations d'erreur.
icon
Contactez-nous