Codes de statut API

Erreurs

Koncile utilise les codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec d'une requête API. En général :

• Les codes dans la plage 2xx indiquent un succès.

• Les codes dans la plage 4xx indiquent une erreur due aux informations fournies (par exemple, un paramètre obligatoire a été omis, un paiement a échoué, etc.).

• Les codes dans la plage 5xx indiquent une erreur des serveurs Koncile (ces cas sont rares).

Certaines erreurs 4xx qui peuvent être gérées programmatiquement incluent un message d'erreur qui explique brièvement l'erreur signalée.

Codes de statut

Code de statut	Détails	Définition
200	OK	Tout a fonctionné comme prévu.
307	Temporary Redirect	L'URL de la requête manque le '/' final
400	Bad Request	La requête était inacceptable, souvent en raison d'un paramètre obligatoire manquant.
401	Unauthorized	Aucune clé API valide fournie.
402	Request Failed	Les paramètres étaient valides mais la requête a échoué.
403	Forbidden	La clé API n'a pas les permissions pour effectuer la requête.
404	Not Found	La ressource demandée n'existe pas.
422	Unprocessable Entity	Les paramètres de la requête sont invalides.
500, 502, 503, 504	Server Errors	Un problème est survenu du côté de Koncile. (Ces cas sont rares.)