From d368af9de44b83102b339ac0155705a4889a1d8d Mon Sep 17 00:00:00 2001
From: Stefan Pfahler <stefanpfahler@gmx.de>
Date: Sat, 31 Dec 2022 12:28:37 +0100
Subject: [PATCH] doc: updated openapi documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Philipp Wörndle <philipp11198@gmail.com>
Signed-off-by: Stefan Pfahler <stefanpfahler@gmx.de>
---
 .../Controllers/ResourcesController.cs        | 33 +++++++++++--------
 .../lib/api/ResourceService.ts                |  1 -
 2 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/src/deskstar-backend/Deskstar/Controllers/ResourcesController.cs b/src/deskstar-backend/Deskstar/Controllers/ResourcesController.cs
index 32cf31c9..7a8bfd63 100644
--- a/src/deskstar-backend/Deskstar/Controllers/ResourcesController.cs
+++ b/src/deskstar-backend/Deskstar/Controllers/ResourcesController.cs
@@ -37,6 +37,7 @@ public ResourcesController(ILogger<ResourcesController> logger, IResourceUsecase
     /// </remarks>
     ///
     /// <response code="200">Returns the buildings list</response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpGet("buildings")]
     [Authorize]
@@ -67,7 +68,7 @@ public IActionResult GetAllBuildings()
     ///     POST /resources/buildings with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="200">Ok</response>
+    /// <response code="200">CreateBuildingResponseObject</response>
     /// <response code="400">Bad Request</response>
     /// <response code="404">Not Found</response>
     /// <response code="500">Internal Server Error</response>
@@ -114,8 +115,8 @@ public IActionResult CreateBuilding(CreateBuildingDto buildingDto)
     ///     DELETE /resources/buildings/3de7afbf-0289-4ba6-bada-a34353c5548a with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="205"></response>
-    /// <response code="500">Internal Server Error</response>
+    /// <response code="400">Bad Request</response>
+    /// <response code="501">Not Implemented</response>
     [HttpDelete("buildings/{buildingId}")]
     [Authorize(Policy = "Admin")]
     [ProducesResponseType(StatusCodes.Status205ResetContent)]
@@ -137,6 +138,7 @@ public IActionResult DeleteBuilding(string buildingId)
     /// </remarks>
     ///
     /// <response code="200">Returns the floor list</response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpGet("buildings/{buildingId}/floors")]
     [Authorize]
@@ -166,7 +168,7 @@ public IActionResult GetFloorsByBuildingId(string buildingId)
     ///     POST /resources/floors with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="200">Ok</response>
+    /// <response code="200">CreateFloorResponseObject</response>
     /// <response code="400">Bad Request</response>
     /// <response code="404">Not Found</response>
     /// <response code="500">Internal Server Error</response>
@@ -212,8 +214,8 @@ public IActionResult CreateFloor(CreateFloorDto floorDto)
     ///     DELETE /resources/floors/3de7afbf-0289-4ba6-bada-a34353c5548a with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="205"></response>
-    /// <response code="500">Internal Server Error</response>
+    /// <response code="400">Bad Request</response>
+    /// <response code="501">Not Impelemented</response>
     [HttpDelete("floors/{floorId}")]
     [Authorize(Policy = "Admin")]
     [ProducesResponseType(StatusCodes.Status205ResetContent)]
@@ -234,6 +236,7 @@ public IActionResult DeleteFloor(string floorId)
     /// </remarks>
     ///
     /// <response code="200">Returns the rooms list</response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpGet("floors/{floorId}/rooms")]
     [Authorize]
@@ -263,7 +266,7 @@ public IActionResult GetRoomsByFloorId(string floorId)
     ///     POST /resources/rooms with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="200">Ok</response>
+    /// <response code="200">CreateRoomResponseObject</response>
     /// <response code="400">Bad Request</response>
     /// <response code="404">Not Found</response>
     /// <response code="500">Internal Server Error</response>
@@ -310,8 +313,8 @@ public IActionResult CreateRoom(CreateRoomDto roomDto)
     ///     DELETE /resources/rooms/3de7afbf-0289-4ba6-bada-a34353c5548a with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="205"></response>
-    /// <response code="500">Internal Server Error</response>
+    /// <response code="400">Bad Request</response>
+    /// <response code="501">Not Implemented</response>
     [HttpDelete("rooms/{roomId}")]
     [Authorize(Policy = "Admin")]
     [ProducesResponseType(StatusCodes.Status205ResetContent)]
@@ -333,6 +336,7 @@ public IActionResult DeleteRoom(string roomId)
     /// </remarks>
     ///
     /// <response code="200">Returns the desks list</response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpGet("rooms/{roomId}/desks")]
     [Authorize]
@@ -420,7 +424,7 @@ public IActionResult GetDeskDetailsByDeskId(string deskId, long start = 0, long
     ///     POST /resources/desks with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="200">Ok</response>
+    /// <response code="200">CreateDeskResponseObject</response>
     /// <response code="400">Bad Request</response>
     /// <response code="404">Not Found</response>
     /// <response code="500">Internal Server Error</response>
@@ -468,8 +472,8 @@ public IActionResult CreateDesk(CreateDeskDto deskDto)
     ///     DELETE /resources/desks/3de7afbf-0289-4ba6-bada-a34353c5548a with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="205"></response>
-    /// <response code="500">Internal Server Error</response>
+    /// <response code="400">Bad Request</response>
+    /// <response code="501">Not Implemented</response>
     [HttpDelete("desks/{deskId}")]
     [Authorize(Policy = "Admin")]
     [ProducesResponseType(StatusCodes.Status205ResetContent)]
@@ -488,8 +492,8 @@ public IActionResult DeleteDesk(string deskId)
     ///     POST /resources/desktypes with JWT-Admin Token
     /// </remarks>
     ///
-    /// <response code="201"></response>
-    /// <response code="400"></response>
+    /// <response code="200">CreateDeskTypeResponseObject</response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpPost("desktypes")]
     [Authorize(Policy = "Admin")]
@@ -522,6 +526,7 @@ public IActionResult CreateDeskType(CreateDeskTypeDto deskTypeDto)
     /// </remarks>
     ///
     /// <response code="200">List<DeskTypeDto></response>
+    /// <response code="400">Bad Request</response>
     /// <response code="500">Internal Server Error</response>
     [HttpGet("desktypes")]
     [Authorize(Policy = "Admin")]
diff --git a/src/deskstar-frontend/lib/api/ResourceService.ts b/src/deskstar-frontend/lib/api/ResourceService.ts
index 7aea3c40..810f9155 100644
--- a/src/deskstar-frontend/lib/api/ResourceService.ts
+++ b/src/deskstar-frontend/lib/api/ResourceService.ts
@@ -288,7 +288,6 @@ export async function createDeskType(
     }
   }
 
-  console.log("x");
   return result;
 }
 type CreateDeskDto = {