This system is designed to manage the rental of beach products at a parador located in the Caribbean. Customers can rent a variety of products such as JetSky, Cuatriciclos, Diving Equipment, and Surfboards (for both kids and adults).
\nThe system handles the entire rental process including product availability, rental duration, payment processing, and discounts.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11325396","collectionId":"411832b8-9f1c-4da6-a488-b844b62b5ee7","publishedId":"2sB2j4gX6N","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-05-02T21:32:12.000Z"},"item":[{"name":"Bookings","item":[{"name":"List Bookings","event":[{"listen":"test","script":{"id":"379d73a8-c376-4a67-b873-f23a01fb6303","exec":[""],"type":"text/javascript","packages":{}}}],"id":"bcd2dfce-1dbc-4291-81f0-2a487fd12f43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/v1/bookings/","description":"This endpoint retrieves a list of all the bookings made.
\n","urlObject":{"protocol":"http","port":"5000","path":["api","v1","bookings",""],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"cfb25292-6902-4d7f-9661-5f9edbbd37df","name":"List Bookings","originalRequest":{"method":"GET","header":[],"url":"http://localhost:5000/api/v1/bookings/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"473"},{"key":"ETag","value":"W/\"1d9-ODGKdnqUhAisFb0Njtc8tK2lIo4\""},{"key":"Date","value":"Fri, 02 May 2025 22:06:03 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"Bookings\": [\n {\n \"_id\": \"6814dea4ecf8db1a392f7b05\",\n \"customerName\": \"Alice Smith\",\n \"date\": \"2025-05-04T00:00:00.000Z\",\n \"rentals\": [\n {\n \"product\": \"6813f67d8a3fc8a2fea66fdf\",\n \"timeSlots\": [\n \"68125fa41b57da2d5b54194a\",\n \"68129f79e881da6514e81146\"\n ],\n \"_id\": \"6814dea4ecf8db1a392f7b06\"\n },\n {\n \"product\": \"6810d671e7112ffff7f85317\",\n \"timeSlots\": [\n \"68125fa41b57da2d5b54194a\"\n ],\n \"_id\": \"6814dea4ecf8db1a392f7b07\"\n }\n ],\n \"paymentMethod\": \"cash\",\n \"isPaid\": false,\n \"createdAt\": \"2025-05-02T15:03:00.131Z\",\n \"total\": 81,\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"bcd2dfce-1dbc-4291-81f0-2a487fd12f43"},{"name":"Create Booking","id":"2305af48-7ed1-4ebf-993d-7d00815b87f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"customerName\": \"Alice Smith\",\n \"date\": \"2025-05-04\",\n \"rentals\": [\n {\n \"product\": \"6813f67d8a3fc8a2fea66fdf\",\n \"timeSlots\": [\n \"68125fa41b57da2d5b54194a\",\n \"68129f79e881da6514e81146\"\n ]\n },\n {\n \"product\": \"6810d671e7112ffff7f85317\",\n \"timeSlots\": [\n \"68125fa41b57da2d5b54194a\"\n ]\n }\n ],\n \"paymentMethod\": \"cash\",\n \"isPaid\": false\n}\n\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/v1/bookings/create","description":"The endpoint creates a new booking with the provided details.
\ncustomerName (string): The name of the customer.
\ndate (string): The date of the booking.
\nrentals (array): An array of rental details including the product and time slots.
\nproduct (string): The ID of the product being rented.
\ntimeSlots (array): An array of time slot IDs.
\npaymentMethod (string): The method of payment.
\nisPaid (boolean): Indicates if the booking is paid.
\nThe response will be a JSON object with the following schema:
\ncustomerName (string): The name of the customer.
\ndate (string): The date of the booking.
\nrentals (array): An array of rental details including the product, time slots, and a unique ID.
\nproduct (string): The ID of the product being rented.
\ntimeSlots (array): An array of time slot IDs.
\n_id (string): The unique ID of the rental.
\npaymentMethod (string): The method of payment.
\nisPaid (boolean): Indicates if the booking is paid.
\n_id (string): The unique ID of the booking.
\ncreatedAt (string): The timestamp of when the booking was created.
\ntotal (number): The total amount of the booking.
\n__v (number): Version key for internal use.
\nThis endpoint sends an HTTP GET request to retrieve a list of products from the server. The response of this request can be documented as a JSON schema.
\nThe response will consist of an array of product objects, where each object will contain properties such as product ID, name, description, price, and any other relevant details about the products.
\nThe JSON schema for the response will define the structure of the product object, including the data types and formats of each property, as well as any required or optional fields.
\nFor example:
\n{\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"productId\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"price\": {\n \"type\": \"number\"\n }\n // ... other properties\n },\n \"required\": [\"productId\", \"name\", \"price\"]\n }\n}\n\nThis endpoint allows the creation of a new product in the system.
\nMethod: POST
\nURL: http://localhost:5000/api/v1/products/create
Body:
\nname: (string) The name of the product.
category: (string) The category of the product.
requiresHelmet: (boolean) Indicates if the product requires a helmet.
requiresLifeJacket: (boolean) Indicates if the product requires a life jacket.
capacity: (number) The capacity of the product.
durationPerSlot: (number) The duration per slot for the product.
maxDurationConsecutive: (number) The maximum consecutive duration for the product.
minReserveAnticipation: (number) The minimum reservation anticipation for the product.
maxReserveAnticipation: (number) The maximum reservation anticipation for the product.
inventaryQuantity: (number) The quantity available in inventory for the product.
isForKids: (boolean) Indicates if the product is for kids.
The response for this request will be a JSON object conforming to the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"productId\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"requiresHelmet\": {\n \"type\": \"boolean\"\n },\n \"requiresLifeJacket\": {\n \"type\": \"boolean\"\n },\n \"capacity\": {\n \"type\": \"number\"\n },\n \"durationPerSlot\": {\n \"type\": \"number\"\n },\n \"maxDurationConsecutive\": {\n \"type\": \"number\"\n },\n \"minReserveAnticipation\": {\n \"type\": \"number\"\n },\n \"maxReserveAnticipation\": {\n \"type\": \"number\"\n },\n \"inventaryQuantity\": {\n \"type\": \"number\"\n },\n \"isForKids\": {\n \"type\": \"boolean\"\n }\n }\n}\n\nThis endpoint allows the client to update the details of a specific product.
\nprice (number): The updated price of the product.
name (string): The updated name of the product.
category (string): The updated category of the product.
requiresHelmet (boolean): Indicates whether the product requires a helmet for use.
requiresLifeJacket (boolean): Indicates whether the product requires a life jacket for use.
capacity (number): The updated capacity of the product.
durationPerSlot (number): The updated duration per slot for the product.
maxDurationConsecutive (number): The maximum consecutive duration for the product's use.
minReserveAnticipation (number): The minimum anticipation for making a reservation.
maxReserveAnticipation (number): The maximum anticipation for making a reservation.
isForKids (boolean): Indicates whether the product is for kids.
inventaryQuantity (number): The updated inventory quantity of the product.
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 delete a specific product.
\nThe response for this request is a JSON object with the following schema:
\n{\n \"message\": \"string\"\n}\n\nmessage: a string indicating the result of the delete operation.This endpoint retrieves a list of timeslots available for scheduling. The response is in JSON format and can be documented as a JSON schema.
\nThe response schema for this endpoint can be documented as follows:
\n{\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"timeslotId\": {\n \"type\": \"string\"\n },\n \"startTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"endTime\": {\n \"type\": \"string\",\n \"format\": \"date-time\"\n },\n \"availableCapacity\": {\n \"type\": \"integer\"\n }\n }\n }\n}\n\nThis endpoint allows the creation of a new time slot.
\nMethod: POST
\nURL: http://localhost:5000/api/v1/timeslots/create
Body:
\nstartTime (string, required): The start time of the time slot.
\nendTime (string, required): The end time of the time slot.
\nThe response for this request is a JSON object conforming to the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"startTime\": {\n \"type\": \"string\"\n },\n \"endTime\": {\n \"type\": \"string\"\n }\n }\n}\n\n