RESTful JAX-RS Application : Satcho Furniture

RESTful API : operations disponibles

Operations sur les ressources de type "User"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
users/login	GET	JWT	Non	Connecte l utilisateur si il a fournit un JWT valide et renvoie ce token ainsi que ces informations publiques.
users/login	POST	Aucun	Non	Connecte l'utilisateur si il a fournit une combinaison username-password valide et renvoie un token JWT ainsi que ces informations publiques.
users/me	GET	JWT	Oui	Renvoie les informations publique de l utilisateur si il a fournit un JWT correct.
users/register	POST	Aucun	Non	Créé une ressource de type "user" et renvoie ces informations publique ainsi que son JWT
users/detail	GET	Admin	Non	Renvoie une liste des informations reservees aux admins des ressources de type "user".
users/detail/waiting	GET	Admin	Non	Renvoie une liste des informations reservees aux admins des ressources de type "user" en attente de confirmation d'inscription.
users/detail/confirmed	GET	Admin	Non	Renvoie une liste des informations reservees aux admins des ressources de type "user" dont l'inscription a été confirmée.
users/detail/{id}	GET	Admin	Non	Renvoie les détails d'un user précis.
users/validate/{id}	PATCH	Admin	Non	Renvoie le user DTO et set le waiting du user précis à false et si la validation est positive il le garde son role si non il set le role à customer.
users/takeover/{id}	GET	Admin	Non	Renvoie un JWT de prise de contrôle, et une ressource de type "user" contenant les informations de l'utilisateur contrôlé.

Operations sur les ressources de type "Furniture"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
furniture/{id}	GET	Aucun	Non	Renvoie les informations publiques d'une ressource de type "furniture". (La ressource doit être dans l'état 'disponible à la vente' ou 'vendu')
furniture/detail/{id}	GET	Admin	Non	Renvoie les informations reservees aux admins d'une ressource de type "furniture".
furniture/	GET	Aucun	Non	Renvoie une liste contenant les informations publiques de toutes les ressources de type "furniture" étant dans l'état 'disponible à la vente' ou 'vendu'.
furniture/detail	GET	Admin	Non	Renvoie une liste contenant les informations reservees aux admins de toutes les ressources de type "furniture".
furniture/accepted/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'available', et renvoie les informations mises à jour.
furniture/refused/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'refused', et renvoie les informations mises à jour.
furniture/restoration/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'in_restoration', et renvoie les informations mises à jour.
furniture/available/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'available_for_sale', et renvoie les informations mises à jour. Le body de la requête contient un double 'selling_price'.
furniture/withdraw/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'withdrawn', et renvoie les informations mises à jour.
furniture/sold/{id}	PATCH	Admin	Non	Modifie l'état d'une ressource de type 'furniture' vers 'sold', et renvoie les informations mises à jour. Le champ 'specialSalePrice' est optionnel dans le body de la requête.
furniture/favouritePhoto/{id}	PATCH	Admin	Non	Modifie la photo favorite d'une ressource de type 'furniture', et renvoie les informations mises à jour.
furniture/infos/{id}	PATCH	Admin	Non	Modifie les informations (description / type id / prix de vente) d'une ressource de type furniture, et renvoie les informations mises à jour.

Operations sur les ressources de type "Photo"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
photos/	POST	Admin	Non	Ajoute une image a la base de donnée.
photos/homePage	GET	Aucun	Non	Renvoie une liste de toutes les information sur les ressources de type "photo" qui sont visible dans la home page.
photos/displayFlags/{id}	PATCH	Admin	Non	Modifie les flags 'isVisible' et 'isOnHomePage' d'une ressource de type "photo" (Renvoie la ressource modifiée au format json)
photos/favourite/{furnitureId}	GET	Aucun	Non	Renvoie la ressource de type "photo" référencée comme photo préférée pour un meuble particulier
photos/byFurniture/{furnitureId}	GET	Aucun	Non	Renvoie toutes les ressources de type "photo" référencant une certaine furnitureId (ne renvoie que les photos visibles)
photos/byFurniture/all/{furnitureId}	GET	Admin	Non	Renvoie toutes les ressources de type "photo" référencant une certaine furnitureId (sans exception)
photos/byFurniture/request/{furnitureId}	GET	JWT	Oui	Renvoie toutes les ressources de type "photo" liées à une demande de visite et référencant une certaine furnitureId

Operations sur les ressources de type "FurnitureType"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
furnitureTypes/	GET	Aucun	Non	Renvoie une liste de touts les types de meubles.

Operations sur les ressources de type "Option"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
options/	GET	JWT	Non	Renvoie une liste de toutes les ressources de type option.
options/me	GET	JWT	oui	Renvoie une liste de toutes les ressources de type option mises par l'utilisateur.
options/	POST	JWT	Oui	Crée une ressource de type option et la renvoie.
options/cancel/{id}	PATCH	JWT	Oui	Annule une ressource de type option et renvoie l'option modifiée.

Operations sur les ressources de type "Request for visit"

URI	Methode	Droits requis	Autorise la prise de contrôle	Operation
requestForVisit/	GET	Admin	Non	Renvoie une liste de toutes les ressources de type request_for_visit.
requestForVisit/cancel/{id}	PATCH	Admin	Non	Annule une ressource de type request_for_visit et la renvoie.
requestForVisit/confirm/{id}	PATCH	Admin	Non	Accepte une ressource de type request_for_visit et la renvoie.
requestForVisit/me	GET	JWT	Oui	Renvoie une liste de toutes les ressources de type request_for_visit appartenant à l'utilisateur.