API Design

GET /api/parking/spots/capacity: This endpoint checks the current capacity of the parking lot and provides a price quote for available spots. It helps users understand their options before proceeding with a reservation.
POST /api/parking/reserve: This endpoint allows users to hold or reserve a parking spot tentatively. It should accept parameters like user ID, vehicle details, and desired time window. This is crucial for managing spot availability and preventing double bookings.
POST /api/parking/reserve/complete: After payment is processed, this endpoint finalizes the reservation. It ensures that the spot is officially booked and updates the system accordingly.
POST /api/parking/checkin: This endpoint registers the arrival of a vehicle, marking the spot as occupied. It’s essential for managing real-time occupancy and ensuring smooth gate operations.
POST /api/parking/checkout: This endpoint handles the vehicle's departure, freeing up the spot for future reservations.
POST /api/parking/no-show: This endpoint manages no-show scenarios, allowing the system to release reserved spots after a certain time if the user does not check in.