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.

