Skip to content

Latest commit

 

History

History
209 lines (195 loc) · 5.74 KB

File metadata and controls

209 lines (195 loc) · 5.74 KB

Codes

Succès

  • 200: Requête traitée avec succès;

Erreurs client / serveur

  • 400: La syntaxe de la requête est erronée;
  • 401: Une authentification est nécessaire pour accéder à la ressource;
  • 403: Le serveur a compris la requête, mais refuse de l'exécuter, permission non accordée;
  • 404: Ressource non trouvée;
  • 405: Méthode de requête non autorisée;
  • 411: La longueur de la requête n'a pas été précisée;
  • 429: Le client a émis trop de requêtes dans un délai donné;
  • 500: Erreur interne du serveur;

Codes additionnel

  • 600: Donnée déjà présente dans la base de donnée;
  • 700: L'utilisateur est banni.

Exemples

[200] Requête traitée avec succès


	{
		"timestamp": 1453903559817,
		"status": 200,
		"error": "OK",
		"message": "...",
		"path": "/",
		"data": []
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 200;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête;
  • [array:data]: données récupérés.

[400] La syntaxe de la requête est erronée


	{
		"timestamp": 1453903559817,
		"status": 400,
		"error": "Bad Request",
		"message": "Validation failed for...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 400;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[401] Une authentification est nécessaire pour accéder à la ressource


	{
		"timestamp": 1453903559817,
		"status": 401,
		"error": "Unauthorized",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 401;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[403] Le serveur a compris la requête, mais refuse de l'exécuter, permission non accordée


	{
		"timestamp": 1453903559817,
		"status": 403,
		"error": "Forbidden",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 403;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[404] Ressource non trouvée


	{
		"timestamp": 1453903559817,
		"status": 404,
		"error": "Not Found",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 404;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[405] Méthode de requête non autorisée


	{
		"timestamp": 1453903559817,
		"status": 405,
		"error": "Method Not Allowed",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 405;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[411] La longueur de la requête n'a pas été précisée


	{
		"timestamp": 1453903559817,
		"status": 411,
		"error": "Length Required",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 411;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[429] Le client a émis trop de requêtes dans un délai donné


	{
		"timestamp": 1453903559817,
		"status": 429,
		"error": "Too Many Requests",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 429;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[500] Erreur interne du serveur


	{
		"timestamp": 1453903559817,
		"status": 500,
		"error": "Internal Server Error",
		"message": "...",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 500;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[600] Donnée déjà présente dans la base de donnée


	{
		"timestamp": 1453903559817,
		"status": 600,
		"error": "Http Status 600",
		"message": "Already exists",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 600;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.

[700] L'utilisateur est banni


	{
		"timestamp": 1453903559817,
		"status": 700,
		"error": "Http Status 700",
		"message": "Banned user",
		"path": "/"
	}
  • [integer:timestamp]: timestamp au moment de l'exécution de la requête;
  • [integer:status]: code 700;
  • [string:error]: message d'erreur généralisé;
  • [string:message]: message d'erreur plus détaillé;
  • [string:path]: chemin de la requête.