Code d'état HTTP
Ce sujet définit les spécifications des codes de réponse HTTP pour l'API REST MTPush.
La nouvelle version v4 de l'API Push MTPush est conforme à cette spécification.
Définition des codes d'état
| Code | Description | Explication détaillée |
|---|---|---|
| 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 est comprise mais non acceptée. La description correspondante expliquera la raison. |
| 404 | Introuvable | La ressource n'existe pas, l'utilisateur demandé n'existe pas, et le format de la requête n'est pas pris en charge. |
| 405 | Méthode de requête non adaptée. | Cette opération ne prend pas en charge les requêtes de cette méthode. |
| 410 | Hors ligne | La ressource demandée est hors ligne. Veuillez consulter l'annonce correspondante. |
| 429 | Trop de requêtes | Le nombre de requêtes dépasse la limite. La description correspondante expliquera la raison spécifique. |
| 500 | Erreur interne du service | Une erreur interne s'est produite sur le serveur. Veuillez nous contacter pour résoudre le problème dès que possible. |
| 502 | Proxy invalide | Le serveur de service est hors ligne ou en cours de mise à niveau. Veuillez réessayer plus tard. |
| 503 | Service temporairement indisponible. | Le serveur ne peut pas 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. |
Conformité
- HTTP 200 indique que la requête a été traitée ; il ne garantit pas la réussite de chaque cible de l’envoi par lot. Vérifiez chaque
results[target].successet, en cas d’échec, lisez leerror.codede cet élément. - Les erreurs métier de la requête utilisent le statut 4xx correspondant. La limitation de débit de toute la requête par lot renvoie HTTP 400 ; l’erreur de limitation d’un élément
23008peut figurer dans le corps d’une réponse HTTP 200. - Les erreurs internes du serveur au niveau de la requête utilisent le statut 5xx correspondant, ou 500.
- En cas d'anomalie métier, le contenu retourné utilise le format JSON pour définir les informations d'erreur
