This API endpoint is used to authenticate and login a user.
\nMethod: POST
\nEndpoint: {{baseURL}}/api/login
\nContent-Type: application/json
\nExample:
\n{\n \"email\": \"{{userEmail}}\",\n \"password\": \"{{userPassword}}\"\n}\n## Response\nThe response for this request is a JSON object with the following schema:\n```json\n{\n \"type\": \"object\",\n \"properties\": {\n \"token\": {\n \"type\": \"string\"\n }\n }\n}\n\nThe response contains a token which can be used for further authenticated requests.
\n","urlObject":{"path":["api","login"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"9abcf550-b364-467e-89da-c7c4d4775f42"},{"name":"Identify User","event":[{"listen":"test","script":{"id":"ec5bdad1-8904-4901-a7de-a1b53c3d8744","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response body contains user identifier\", function () {\r"," var jsonData = pm.response.json();\r"," // Example: Check if the message contains the user's email or ID\r"," // Adjust based on your actual response structure\r"," pm.expect(jsonData.message).to.include(pm.environment.get(\"userEmail\"));\r"," // or check for ID if it's included\r"," // pm.expect(jsonData.message).to.include(\"id\");\r","});"],"type":"text/javascript","packages":{}}}],"id":"c2517d7e-46cc-410d-a5d0-a2981a744c90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/identify","description":"This API endpoint sends an HTTP GET request to the specified URL in order to identify the resource.
\nThe request does not require a request body. It only includes the base URL and the endpoint URL.
\nbaseURL (string, required): The base URL for the API.The response for this request is a JSON schema describing the structure of the response data.
\n","urlObject":{"path":["api","identify"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c2517d7e-46cc-410d-a5d0-a2981a744c90"},{"name":"Logout User","event":[{"listen":"test","script":{"id":"00ec9ddd-f352-4ccb-9320-3ba6a0a06afc","exec":["pm.test(\"Status code is 302 Found (Redirect)\", function () {\r"," // Flask redirect usually returns 302\r"," pm.response.to.have.status(302);\r","});\r","\r","pm.test(\"Response should clear the 'access_token' cookie\", function () {\r"," // --- Configuration ---\r"," // Set the exact name of the cookie you expect to be cleared.\r"," // This should match your Flask config's JWT_ACCESS_COOKIE_NAME.\r"," const targetCookieName = \"access_token\";\r"," // --- End Configuration ---\r","\r"," let cookieCleared = false;\r"," let foundMatchingCookieHeader = false;\r"," const receivedSetCookieHeaders = [];\r","\r"," // 1. Iterate through all response headers\r"," pm.response.headers.all().forEach(header => {\r"," // 2. Check if it's a 'Set-Cookie' header (case-insensitive)\r"," if (header.key.toLowerCase() === 'set-cookie') {\r"," const cookieString = header.value;\r"," receivedSetCookieHeaders.push(cookieString); // Store for debugging\r","\r"," // 3. Check if this specific header targets our cookie\r"," // It must start with \"cookieName=\"\r"," if (cookieString.trim().startsWith(targetCookieName + \"=\")) {\r"," foundMatchingCookieHeader = true; // We found a header for our cookie\r","\r"," // 4. Check if this header contains instructions to clear the cookie\r"," // Method A: Max-Age=0\r"," const hasMaxAgeZero = cookieString.includes('Max-Age=0');\r","\r"," // Method B: Expires date in the past (specifically checking Unix epoch start)\r"," // Adjust the date string if your server uses a slightly different past date format\r"," const hasPastExpires = cookieString.includes('Expires=Thu, 01 Jan 1970');\r","\r"," if (hasMaxAgeZero || hasPastExpires) {\r"," cookieCleared = true;\r"," // We found a header that both targets the cookie AND clears it.\r"," // We can technically stop checking now, but looping through all is fine.\r"," }\r"," }\r"," }\r"," });\r","\r"," // 5. Assertion and Debugging Output\r"," if (!cookieCleared) {\r"," // Log detailed information only if the test fails\r"," console.error(`TEST FAILED: Did not find a valid clearing directive for the '${targetCookieName}' cookie.`);\r"," if (!foundMatchingCookieHeader) {\r"," console.log(` - Reason: No 'Set-Cookie' header starting with '${targetCookieName}=' was found.`);\r"," } else {\r"," console.log(` - Reason: Found 'Set-Cookie' header(s) for '${targetCookieName}', but none contained 'Max-Age=0' or 'Expires=Thu, 01 Jan 1970...'.`);\r"," }\r"," console.log(\" - Received 'Set-Cookie' Headers were:\");\r"," if (receivedSetCookieHeaders.length > 0) {\r"," receivedSetCookieHeaders.forEach((h, index) => console.log(` [${index}]: ${h}`));\r"," } else {\r"," console.log(\" (None)\");\r"," }\r"," }\r","\r"," // The actual assertion\r"," pm.expect(cookieCleared, `Expected a Set-Cookie header to clear the '${targetCookieName}' cookie via Max-Age=0 or Expires=past_date`).to.be.true;\r","});\r","\r","pm.test(\"Clear authToken environment variable\", function () {\r"," pm.environment.unset(\"authToken\");\r"," console.log(\"Auth Token cleared.\");\r","});"],"type":"text/javascript","packages":{}}}],"id":"abe12be2-4c5a-46a1-b80b-9ae223668709","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/logout","description":"This endpoint sends an HTTP GET request to {{baseURL}}/logout to log the user out of the system.
\nThe response of this request can be documented as a JSON schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis API endpoint makes an HTTP GET request to {{baseURL}}/api/identify in order to identify the user.
\nThe request does not require any specific parameters.
\nThe response for this request is a JSON object containing the identification details of the user. You can refer to the JSON schema below for the structure of the response:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"userId\": {\n \"type\": \"string\"\n },\n \"userName\": {\n \"type\": \"string\"\n },\n \"userType\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis API endpoint is used to authenticate and login a user.
\nemail (string) - The email of the user.
password (string) - The password of the user.
The response will include the authentication token and user information upon successful login.
\n","urlObject":{"path":["api","login"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0505836-4ff8-4b82-ba63-4142598d9383"}],"id":"fba2f404-067e-4e45-ba71-a3e28e26627d","_postman_id":"fba2f404-067e-4e45-ba71-a3e28e26627d","description":""},{"name":"Assets","item":[{"name":"Get All Assets","event":[{"listen":"test","script":{"id":"0ce4dec0-5d51-4888-a6df-22ee3677bf39","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response is a JSON array\", function () {\r"," pm.response.to.be.json;\r"," pm.expect(pm.response.json()).to.be.an('array');\r","});\r","\r","pm.test(\"Assets have expected properties\", function () {\r"," const assets = pm.response.json();\r"," if (assets.length > 0) {\r"," pm.expect(assets[0]).to.have.property('id');\r"," pm.expect(assets[0]).to.have.property('description');\r"," pm.expect(assets[0]).to.have.property('room_id');\r"," pm.expect(assets[0]).to.have.property('status');\r"," pm.expect(assets[0]).to.have.property('assignee_name'); // Check enriched data\r"," pm.expect(assets[0]).to.have.property('room_name'); // Check enriched data\r"," }\r","});"],"type":"text/javascript","packages":{}}}],"id":"67561beb-55b7-46a6-83bb-04ca6f4f5866","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/assets","description":"This endpoint is used to retrieve a list of assets.
\nMethod: GET
\nURL: {{baseURL}}/api/assets
The response for this request follows the JSON schema below:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"assets\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"assetId\": {\n \"type\": \"string\"\n },\n \"assetName\": {\n \"type\": \"string\"\n },\n \"assetType\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n }\n // ... additional properties\n }\n }\n }\n }\n}\n\nThis endpoint allows you to add a new asset by sending an HTTP POST request to {{baseURL}}/api/asset/add. The request should include the following parameters in the request body:
\nid (string): The unique identifier for the asset, which can be set using the format \"PM_TEST_1786989274\" to include a timestamp in the ID.
description (string): A brief description of the asset, such as \"Postman Test Asset\".
brand (string): The brand of the asset, for example, \"TestBrand\".
model (string): The model of the asset, e.g., \"TestModel\".
serial_number (string): The serial number of the asset, which can be set using the format \"PM673\" to include a random integer in the serial number.
room_id (string): The ID of the room where the asset is located, such as \"1\".
assignee_name (string): The name of the person assigned to the asset, for example, \"John Doe\".
notes (string): Any additional notes or comments related to the asset, such as \"Created via Postman test\".
The response to this request will provide information about the newly added asset.
\n","urlObject":{"path":["api","asset","add"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"aa8ba741-2cc3-412d-9a47-2e2f7fbffcb3"},{"name":"Get Created Asset","event":[{"listen":"test","script":{"id":"174f4c68-0a2e-4158-9f2d-cdc3267cfacd","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response contains the correct asset ID\", function () {\r"," var jsonData = pm.response.json();\r"," // Asset ID might be in 'id' or 'id:' depending on your get_json\r"," const idKey = jsonData.hasOwnProperty('id') ? 'id' : 'id:';\r"," pm.expect(jsonData[idKey]).to.eql(pm.environment.get(\"newAssetId\"));\r","});\r","\r"," pm.test(\"Response contains enriched data (room_name, assignee_name)\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData).to.have.property('room_name');\r"," pm.expect(jsonData).to.have.property('assignee_name');\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"a3539c82-76cc-4978-a5a0-3c3f364af109","exec":[],"type":"text/javascript"}}],"id":"3d8242fa-30ef-4ab5-88a9-f3e3957679ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authToken}}","type":"text"}],"url":"{{baseURL}}/api/asset/{{newAssetId}}","description":"This endpoint retrieves information about a specific asset identified by the provided asset ID. The request does not contain a request body, as it is a GET request. The response will include details about the asset such as its name, type, location, and other relevant information.
\n","urlObject":{"path":["api","asset","{{newAssetId}}"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d8242fa-30ef-4ab5-88a9-f3e3957679ba"},{"name":"Update Asset Details","event":[{"listen":"test","script":{"id":"12f18995-9f9e-4fe1-ba28-4eda7cab7d41","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response indicates success\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData.message).to.include(\"updated successfully\");\r","});\r","\r","pm.test(\"Response contains updated asset data\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.asset.description).to.eql(\"Updated Postman Test Asset\");\r"," pm.expect(jsonData.asset.assignee_id).to.eql(2); // Check if assignee ID changed\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"2c84eed7-787f-4a04-8241-8a2742c195fe","exec":[],"type":"text/javascript"}}],"id":"9176c01f-1bd2-4a93-b4a8-f4b0cd42f015","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"description\": \"Updated Postman Test Asset\",\r\n \"brand\": \"UpdatedBrand\",\r\n \"model\": \"UpdatedModel\",\r\n \"serial_number\": \"PM265_UPD\",\r\n \"assignee_id\": 2, // Change assignee\r\n \"notes\": \"Updated via Postman test\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/asset/{{newAssetId}}/update","description":"This endpoint is used to update an existing asset with the provided details.
\ndescription (string): Updated description of the asset.
brand (string): Updated brand of the asset.
model (string): Updated model of the asset.
serial_number (string): Updated serial number of the asset.
assignee_id (integer): ID of the user to whom the asset is assigned.
notes (string): Additional notes or comments for the asset.
The response for this request will be a JSON object conforming to the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis endpoint is used to mark a specific asset as found.
\nfoundDate (string, required): The date when the asset was found.The response of this request is a JSON schema. Please refer to the schema for details.
\n","urlObject":{"path":["api","asset","{{newAssetId}}","mark-found"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1aa69987-63b0-4cb2-b1a5-cebba51597e9"},{"name":"Upload Assets CSV (Structure Only)","event":[{"listen":"test","script":{"id":"67ed2193-a5be-444e-b2fc-0a8ce8b05734","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," // This might be 400 if the file is invalid, adjust as needed\r"," pm.expect(pm.response.code).to.be.oneOf([200, 400]);\r","});\r","\r","pm.test(\"Response indicates success or failure with details\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData).to.have.property('success'); // Should be true or false\r"," pm.expect(jsonData).to.have.property('message');\r"," pm.expect(jsonData).to.have.property('details'); // Contains import/skip counts, errors\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"849b0b78-4e25-4ec6-998d-737f9234f766","exec":[],"type":"text/javascript"}}],"id":"8abd7aa3-d805-4108-acc2-bedc045ed728","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"csvFile","type":"file","uuid":"957d2370-76be-4fa0-ade8-716c25bfb9c4","src":"postman-cloud:///1f01ce93-b35e-41b0-94eb-364df7230545"}]},"url":"{{baseURL}}/api/upload/assets-csv","description":"This endpoint allows you to upload a CSV file containing assets data.
\nThe request should be made using the HTTP POST method to the following URL: {{baseURL}}/api/upload/assets-csv
csvFile (file): The CSV file containing assets data.The response for this request is a JSON object conforming to the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n // Define the properties of the response JSON schema here\n }\n}\n\nThis endpoint allows you to add a new building to the system. The request should be sent as an HTTP POST to {{baseURL}}/api/building/add with the following payload in the raw request body:
\n{\n \"building_name\": \"BuildingToDelete_{{$timestamp} ...\"\n}\n\nUpon successful execution, the response will include the details of the newly added building.
\n","urlObject":{"path":["api","building","add"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d29ee188-8c5e-48be-bf0e-2127524e2ba3"},{"name":"Create Floor for Deletion Test","event":[{"listen":"test","script":{"id":"36e0f60b-b5c2-437b-a768-44f374beac8d","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response indicates success and returns floor data\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData).to.have.property('floor');\r"," pm.expect(jsonData.floor).to.have.property('floor_id');\r"," pm.expect(jsonData.floor.building_id).to.eql(pm.environment.get(\"testBuildingId\"));\r"," // Use a dedicated variable for this test sequence\r"," pm.environment.set(\"testFloorId\", jsonData.floor.floor_id);\r"," console.log(\"Test Floor ID set:\", jsonData.floor.floor_id);\r","});"],"type":"text/javascript","packages":{}}}],"id":"a16a6abc-fe1c-4751-b5eb-d8810b9bb422","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"building_id\": \"{{testBuildingId}}\", // Use the specific ID for this test\r\n \"floor_name\": \"FloorToDelete_1786989274\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/floor/add?Content-Type=application/json&Authorization=Bearer {{authToken}}","description":"This endpoint allows the user to add a new floor to a building.
\nMethod: POST
\nBase URL: {{baseURL}}
\nPath: /api/floor/add
\nHeaders:
\nContent-Type: application/json
\nAuthorization: Bearer {{authToken}}
\nBody:
\nbuilding_id (string, required): The ID of the building to which the floor belongs.
\nfloor_name (string, required): The name of the floor to be added.
\nExample:
\n{\n \"building_id\": \"{{testBuildingId}}\",\n \"floor_name\": \"FloorToDelete_1786989274\"\n}\n### Response\nThe response for this request will be a JSON object with the schema:\n```json\n{\n \"type\": \"object\",\n \"properties\": {\n // Response properties here\n }\n}\n\nThe endpoint allows the addition of a new room via an HTTP POST request to {{baseURL}}/api/room/add. The request should include the \"Content-Type\" header set to \"application/json\" and the \"Authorization\" header with a bearer token in the format \"Bearer {{authToken}}\".
\nThe request body should be in raw JSON format and include the \"floor_id\" and \"room_name\" parameters. The \"floor_id\" should contain the ID of the floor where the room is to be added, and the \"room_name\" should specify the name of the room. The \"room_name\" parameter supports the use of 1786989274 as a placeholder for the current timestamp.
\nThe response to this request will be documented as a JSON schema.
\n","urlObject":{"path":["api","room","add"],"host":["{{baseURL}}"],"query":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{authToken}}"}],"variable":[]}},"response":[],"_postman_id":"0a23596a-920b-4351-979f-f02b3a94d3d6"},{"name":"Delete the Newly Created (Empty) Room","event":[{"listen":"test","script":{"id":"ac885cbb-92ac-448a-b66b-a6a54ab48556","exec":["// Test: Expect SUCCESSFUL deletion (200 OK) because this room should be empty\r","pm.test(\"Status code is 200 OK (Successful Deletion Expected)\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test: Check the response message for success\r","pm.test(\"Response message indicates successful deletion\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData.message).to.eql(\"Room deleted successfully\");\r","});\r","\r","// Test: Clear the environment variable now that it's deleted\r","pm.test(\"Clear testRoomId environment variable\", function () {\r"," pm.environment.unset(\"testRoomId\");\r"," console.log(\"Cleared testRoomId.\");\r","});"],"type":"text/javascript","packages":{}}}],"id":"5f9e6ffd-f888-4b86-bde5-891d143900c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/room/{{testRoomId}}/delete","description":"This endpoint is used to delete a specific room.
\nThis endpoint makes an HTTP GET request to retrieve information about a specific room on the specified floor. The request should include the floor ID in the URL path.
\nThis request does not require a request body.
\nroomId (string): The unique identifier of the room.
roomName (string): The name or number of the room.
roomCapacity (integer): The maximum capacity of the room in terms of number of people.
roomStatus (string): The current status of the room (e.g., available, occupied).
roomFeatures (array of strings): The list of features available in the room.
This endpoint is used to delete a specific floor.
\nMethod: DELETE
\nURL: {{baseURL}}/api/floor/{{testFloorId}}/delete
Path Parameters:
\ntestFloorId: The unique identifier of the floor to be deleted.The response for this request is a JSON object conforming to the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nThe response body contains a message property which provides information about the success or failure of the deletion operation.
This endpoint is used to delete a specific building identified by the testBuildingId.
The response for this request is a JSON schema representing the success or failure of the deletion operation. The schema includes the following properties:
\nstatus: (string) Indicates the status of the deletion operation.
message: (string) Provides a message related to the deletion operation.
Example Response:
\n{\n \"status\": \"success\",\n \"message\": \"Building deleted successfully\"\n}\n\nThis endpoint is used to retrieve a list of buildings.
\nThis request does not require a request body.
\nbuildings: An array of building objects containing information about each building, such as building name, address, and other details.Example:
\n{\n \"buildings\": [\n {\n \"name\": \"Building 1\",\n \"address\": \"123 Main Street\",\n ...\n },\n {\n \"name\": \"Building 2\",\n \"address\": \"456 Elm Street\",\n ...\n },\n ...\n ]\n}\n\nThis endpoint allows the addition of a new building.
\nbuilding_name (string, required): The name of the building.The response for this request follows the JSON schema below:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis endpoint allows the addition of a new floor to a building.
\nMethod: POST
\nURL: {{baseURL}}/api/floor/add
Body:
\nbuilding_id (string, required): The ID of the building to which the floor belongs.
floor_name (string, required): The name of the new floor.
The response for this request is a JSON object with the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"floor_id\": {\n \"type\": \"string\"\n }\n }\n}\n\nstatus (string): The status of the response.
message (string): A message providing information about the operation.
floor_id (string): The ID of the newly added floor.
This endpoint retrieves the floors of a specific building.
\nMethod: GET
\nURL: {{baseURL}}/api/floors/{{newBuildingId}}
The response for this request can be documented as a JSON schema. The schema will describe the structure of the response body returned by the API endpoint.
\n","urlObject":{"path":["api","floors","{{newBuildingId}}"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"482ce455-3402-49f4-a1ae-ea975073b019"},{"name":"Create New Room","event":[{"listen":"test","script":{"id":"c3d5c41b-0a66-45cd-86ef-50fb815b6c88","exec":["pm.test(\"Status code is 200 OK\", function () { // API returns 200\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response indicates success and returns room data\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData).to.have.property('room');\r"," pm.expect(jsonData.room).to.have.property('room_id');\r"," pm.expect(jsonData.room.floor_id).to.eql(pm.environment.get(\"newFloorId\"));\r","\r"," // Save the new room ID\r"," pm.environment.set(\"newRoomId\", jsonData.room.room_id);\r"," console.log(\"New Room ID set:\", jsonData.room.room_id);\r","});"],"type":"text/javascript","packages":{}}}],"id":"b62fc87e-d1d9-4603-92d0-7f24444689fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"floor_id\": \"{{newFloorId}}\", // Assumes newFloorId was set by \"Create New Floor\"\r\n \"room_name\": \"PM Room 540\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/room/add","description":"This endpoint allows you to add a new room to a specific floor.
\nMethod: POST
\nURL: {{baseURL}}/api/room/add
Body:
\nfloor_id (string, required): The ID of the floor to which the room belongs.
room_name (string, required): The name of the room.
The response for this request is a JSON object following the schema below:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"room_id\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis endpoint makes an HTTP GET request to retrieve information about a specific room on the specified floor. The request URL should be in the format {{baseURL}}/api/rooms/{{newFloorId}}.
\nNo request body is required for this request. The newFloorId parameter should be included in the request URL to specify the floor for which the room information is being retrieved.
The response will be a JSON object representing the details of the room on the specified floor. The JSON schema for the response can be documented as follows:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"roomId\": {\n \"type\": \"string\"\n },\n \"roomName\": {\n \"type\": \"string\"\n },\n \"roomCapacity\": {\n \"type\": \"integer\"\n },\n \"roomStatus\": {\n \"type\": \"string\"\n }\n // Additional properties may be included based on the specific room details\n }\n}\n\nThis endpoint is used to update a specific room identified by the newRoomId within the API. The HTTP POST request should be made to {{baseURL}}/api/room/{{newRoomId}}/update. The request body should be in raw format and include the following parameters:
floor_id: The ID of the new floor to which the room will be assigned.
room_name: The updated name for the room.
The response to this request will contain the updated details of the room, including its ID, floor assignment, and name.
\n","urlObject":{"path":["api","room","{{newRoomId}}","update"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2db8089e-3a1e-4cd8-8a99-afd4afc3867c"},{"name":"Delete Room","event":[{"listen":"test","script":{"id":"81603f56-0bb6-4fe7-b31b-fb4f4ee244f9","exec":["// Test: Check for expected status codes (Success or Failure)\r","pm.test(\"Status code is 200 OK (Success) or 400 Bad Request (Failure)\", function () {\r"," // Allow either 200 (if deletion succeeds) or 400 (if deletion fails due to usage)\r"," pm.expect(pm.response.code).to.be.oneOf([200, 400]);\r","});\r","\r","// Test: Check the response message based on the status code\r","pm.test(\"Response message matches status\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData).to.have.property('success'); // Should always have success key\r"," pm.expect(jsonData).to.have.property('message'); // Should always have message key\r","\r"," if (pm.response.code === 200) {\r"," // If status is 200, expect success\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData.message).to.eql(\"Room deleted successfully\");\r"," } else if (pm.response.code === 400) {\r"," // If status is 400, expect failure and the specific message\r"," pm.expect(jsonData.success).to.be.false;\r"," pm.expect(jsonData.message).to.include(\"Failed to delete room\"); // Check includes part of the message\r"," pm.expect(jsonData.message).to.include(\"in use by assets\"); // Check includes part of the message\r"," } else {\r"," // If status is something else entirely, fail the test explicitly\r"," pm.expect.fail(`Unexpected status code: ${pm.response.code}`);\r"," }\r","});\r","\r","// Test: Clear environment variable ONLY on successful deletion\r","pm.test(\"Clear newRoomId environment variable on success\", function () {\r"," if (pm.response.code === 200) {\r"," pm.environment.unset(\"newRoomId\");\r"," console.log(\"Cleared newRoomId because deletion was successful.\");\r"," } else if (pm.response.code === 400) {\r"," console.log(\"Did not clear newRoomId because deletion failed (room likely in use).\");\r"," } else {\r"," console.warn(`Did not clear newRoomId due to unexpected status code: ${pm.response.code}`);\r"," }\r"," // This test doesn't strictly assert anything, but logs the action.\r"," // If you wanted to assert it was *not* cleared on 400, you could add:\r"," // else if (pm.response.code === 400) {\r"," // pm.expect(pm.environment.has(\"newRoomId\")).to.be.true;\r"," // }\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"a7784c27-d41c-44ca-829d-ad43903f39a8","exec":[],"type":"text/javascript"}}],"id":"edfbf146-642c-4ac1-bf43-2ce6cbb20641","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/room/{{newRoomId}}/delete","description":"This endpoint is used to delete a specific room.
\nMethod: DELETE
\nURL: {{baseURL}}/api/room/{{newRoomId}}/delete
Path Parameters:
\nnewRoomId: The ID of the room to be deleted.The response for this request is a JSON schema. The schema includes the following properties:
\nstatus: The status of the request, indicating success or failure.
message: A message providing information about the result of the request.
Example Response:
\n{\n \"status\": \"success\",\n \"message\": \"Room deleted successfully\"\n}\n\nThis endpoint is used to update a specific floor in a building.
\nMethod: POST
\nURL: {{baseURL}}/api/floor/{{newFloorId}}/update
\nHeaders:
\n{ \"building_id\": \"{{newBuildingId}}\", \"floor_name\": \"Updated PM Floor {{$randomInt} ...\"}
\nThe response for this request is a JSON object following the schema below:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nThis endpoint is used to delete a specific floor by providing the newFloorId in the URL path.
Method: DELETE
\nURL: {{baseURL}}/api/floor/{{newFloorId}}/delete
The response for this request is a JSON schema that represents the structure of the response body. It includes the properties and data types of the response object.
\n","urlObject":{"path":["api","floor","{{newFloorId}}","delete"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4e1bd48f-4190-427f-b6c9-fcf5214503c7"},{"name":"Update Building","event":[{"listen":"test","script":{"id":"ed00c83c-c83a-4b21-89ac-f841b6b510e6","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response indicates success\", function () {\r"," pm.expect(pm.response.json().success).to.be.true;\r","});"],"type":"text/javascript","packages":{}}}],"id":"b9ecacb3-2651-4964-9fbd-e11e865e64ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"building_name\": \"Updated Postman Building 655\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/building/{{newBuildingId}}/update","description":"The API endpoint POST /api/building/{{newBuildingId}}/update is used to update a specific building with the provided ID. The request should include the updated details of the building in the request body.
building_name (string, required): The updated name of the building.The response of this request is a JSON schema representing the structure of the response data. It will define the properties and data types of the response object.
\nExample JSON Schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"status\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"properties\": {\n \"building_id\": {\n \"type\": \"string\"\n },\n \"building_name\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n }\n }\n }\n }\n}\n\nThis endpoint is used to delete a specific building by providing the ID of the building to be deleted.
\nThis endpoint allows you to upload a CSV file containing location data. The HTTP POST request should be made to {{baseURL}}/api/upload/locations-csv. The request body should be of form-data type, with a key \"csvFile\" that contains the CSV file to be uploaded.
\nUpon successful upload, the response will include the status of the upload operation and any relevant information about the uploaded file.
\n","urlObject":{"path":["api","upload","locations-csv"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"087c56a6-29fa-470e-b50d-9bc54c70d0ba"}],"id":"89fdbe7a-63e3-4678-9ea7-3a6af208f5e4","_postman_id":"89fdbe7a-63e3-4678-9ea7-3a6af208f5e4","description":""},{"name":"User","item":[{"name":"Get All Users","event":[{"listen":"test","script":{"id":"b79e2c26-01c8-4f5f-86ea-dffc5dfd9738","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response is a JSON array\", function () {\r"," pm.expect(pm.response.json()).to.be.an('array');\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"b46a4354-e4d1-4fb6-bddf-a9aa32400bb0","exec":[],"type":"text/javascript"}}],"id":"8fc7e219-dc71-4a6b-a103-fc65df8161d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/users","description":"This endpoint makes an HTTP GET request to retrieve a list of users from the API. The request does not include a request body as it is a GET request. The response will include an array of user objects, each containing information about a specific user, such as their ID, name, email, and any other relevant details.
\n","urlObject":{"path":["api","users"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8fc7e219-dc71-4a6b-a103-fc65df8161d7"},{"name":"Create New User","event":[{"listen":"test","script":{"id":"0cd1f5bb-3356-48c7-be96-388b923dff2f","exec":["pm.test(\"Status code is 200 OK\", function () { // API returns 200 based on code\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response indicates success\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData.success).to.be.true;\r"," pm.expect(jsonData).to.have.property('user');\r"," pm.expect(jsonData.user).to.have.property('id');\r"," pm.environment.set(\"newUserId\", jsonData.user.id);\r"," console.log(\"New User ID set:\", jsonData.user.id);\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"5be929ad-e530-4ad3-89c9-2a60886f096c","exec":[],"type":"text/javascript"}}],"id":"a7a2f25f-d55f-4a64-b8da-acc468da3594","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"postman_test_203@mail.com\",\r\n \"username\": \"pm_user_265\",\r\n \"password\": \"testpassword123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/users/create","description":"This endpoint allows the creation of a new user.
\nemail (string) - The email address of the user.
username (string) - The username for the user.
password (string) - The password for the user.
Example:
\n{\n \"email\": \"postman_test_123@example.com\",\n \"username\": \"pm_user_123\",\n \"password\": \"testpassword123\"\n}\n\nThe response will contain the details of the newly created user.
\n","urlObject":{"path":["api","users","create"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a7a2f25f-d55f-4a64-b8da-acc468da3594"},{"name":"Delete Created User","event":[{"listen":"test","script":{"id":"67aad4ad-d76e-4c8b-904e-949236c71e79","exec":["pm.test(\"Status code is 200 OK\", function () {\r"," pm.response.to.have.status(200);\r","});\r","pm.test(\"Response indicates success\", function () {\r"," pm.expect(pm.response.json().success).to.be.true;\r","});\r"," pm.test(\"Clear newUserId environment variable\", function () {\r"," pm.environment.unset(\"newUserId\");\r","});"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"04acef15-4cd5-4647-979d-c60b99eb2c8f","exec":[],"type":"text/javascript"}}],"id":"eb2c1b6e-b372-41c2-aa9c-f8d7adba0c97","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{authToken}}","type":"text"}],"url":"{{baseURL}}/api/users/{{newUserId}}/delete","description":"This endpoint is used to delete a specific user by their ID.
\nreason (text, required): A brief explanation for deleting the user.The response will not contain a message body. A successful deletion will return a 204 No Content status code.
\n","urlObject":{"path":["api","users","{{newUserId}}","delete"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb2c1b6e-b372-41c2-aa9c-f8d7adba0c97"}],"id":"1bea350a-804a-4add-8fed-a57407c8c83a","_postman_id":"1bea350a-804a-4add-8fed-a57407c8c83a","description":""}]}