Les codes de réponse (codes retours) de nos APIs
Nos APIs utilisent des codes de réponse pour transférer et interroger vos données. Afin d’interroger nos serveurs, il est nécessaire de dialoguer avec lui en lui envoyant des “Commandes”. Une fois que le serveur a reçu une commande, une réponse sera retournée (ACK).
Votre compte vous donne un accès immédiat à notre API gratuite : elle vous permet d’intégrer facilement nos services à vos site web, logiciel ou application CRM en PHP, ASP, .NET, JAVA ou tout autre langage.
Définition
Il y a quatre valeurs possibles pour le premier chiffre du code de réponse. Vous trouvez la déclinaison ci dessous.
Les codes retours API : XXX
| Code |
|
| 2XX |
Réponse positive : l’action demandée a été effectuée avec succès. Une nouvelle demande peut être initiée. |
| 3XX |
Réponse positive temporaire : la commande a été acceptée, mais l’action demandée est en attente de réception de plus amples informations. Le client SMTP devrait envoyer une autre commande spécifiant cette information. |
| 4XX |
Réponse négative d’achèvement transitoire : la commande n’a pas été acceptée et l’action demandée n’a pas pu se produire. Toutefois, la condition de l’erreur est temporaire, et l’action peut être demandée à nouveau. |
| 5XX |
Réponse négative : la commande n’a pas été acceptée et l’action demandée n’a pas pu se produire. |
Les codes retours API : 2XX
| Code |
Message |
Signification |
| 200 |
OK |
Requête traitée avec succès. |
| 201 |
Created |
Requête traitée avec succès et création d’un document. |
| 202 |
Accepted |
Requête traitée, mais sans garantie de résultat. |
Les codes retours API : 3XX
| Code |
Message |
Signification |
| 301 |
Moved Permanently |
Document déplacé de façon permanente. |
Les codes retours API : 4XX
405Method Not AllowedMéthode de requête non autorisée.408Request Time-outTemps d’attente d’une requête du client, écoulé côté serveur.
| Code |
Message |
Signification |
| 400 |
Bad Request |
La syntaxe de la requête est erronée. |
| 401 |
Unauthorized |
Une authentification est nécessaire pour accéder à la ressource. |
| 402 |
Payment Required |
Paiement requis pour accéder à la ressource. |
| 403 |
Forbidden |
Le serveur a compris la requête, mais refuse de l’exécuter. |
| 404 |
Not Found |
Ressource non trouvée. |
Les codes retours API : 5XX
| Code |
Message |
Signification |
| 500 |
Internal Server Error |
Erreur interne du serveur. |
| 501 |
Not Implemented |
Fonctionnalité réclamée non supportée par le serveur. |
| 503 |
Service Unavailable |
Service temporairement indisponible ou en maintenance. |
| 504 |
Gateway Time-out |
Temps d’attente d’une réponse d’un serveur à un serveur intermédiaire écoulé. |
