Comprobar disponibilidad de plazas de parking por planta

Última modificación: 23/04/2025

Obtiene un Json con las plazas de parking disponibles de una planta de un edificio.

Comprueba las plazas a las que tiene acceso el usuario mediante los grupos de tipo “manual” y las cesiones disponibles.

Tiene en cuenta las reglas del parking seleccionado: Antelación con la que se puede reservar, tiempo máximo por tramo que puede reservar el usuario, horario de mañana y tarde…

En caso de pedir reserva para todo el día (ALL_DAY) solo se devolverán si se dispone de plazas libres para todo el día, es decir, en ningún caso una plaza de mañana y otra diferente de tarde.

Si la organización NO tiene activado el módulo de vehículo requerido no hay que mandar el campo licensePlate. Si se manda la API devolverá un error.

Si la organización SI tiene activado el módulo de vehículo requerido si hay que mandar el campo vehicleId. Si no se manda la API devolverá un error.

¡IMPORTANTE!

La forma actual en la que se indica el vehículo asociado a la reserva mediante licensePlate queda deprecada y en su lugar se utilizará vehicleId.

Request

HTTP request

POST /api/v1/parkings/bookings/manual/free

Headers

Header	Value	Required
Authorization	Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT…	true

Request

{
  "buildingId": "118ae778-1d81-4589-b02c-8583add71994",
  "floorId": "b60c8462-0c40-4f61-b9ce-1e1179f49da1",
  "subcategoryId": "6e0a5df1-2de7-40f3-8590-2f8e7bc45ef8",
  "bookingDays": [
        {
           "startDate": 1651042800000,
           "endDate": 1651046400000
        }
   ],
  "features": [ // Lista de plazas favoritas del usuario. Se le dara preferencia a dichas plazas.
        "13707331-087b-4693-b38f-c2c03bbf0157",
        "13707331-087b-4693-b38f-c2c03bbf0156"
  ], // Opcional
  "maxCostPerHour": 5.00, // Opcional
  "covered": null, // true; false o null en caso de no querer que filtre
  "parkingSlotSize": null, // SMALL, MEDIUM, BIG o null en caso de no querer que filtre
  "licensePlate": "1234 ABC", // Deprecado
  "vehicleId": "7ff07a0f-44b9-4a99-a359-461c0fb62ba0",
  "electricCharger": null, // true; false o null en caso de no querer que filtre
}

Response

Se devuelve un código 200 con una lista de todas las plazas disponibles.

{
  "freeResources": [
    {
      "id": "797ee36f-6ccd-4fcb-907f-dfac908d6d6f",
      "name": "B-S1-PARK-8",
      "posterCode": "B-S1-PARK-8",
      "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
      "mapCoordinates": {
        "topLeftX": 146,
        "topLeftY": 439,
        "bottomRightX": 171,
        "bottomRightY": 464
      },
      "approachable": false,
      "floor": {
        "id": "b60c8462-0c40-4f61-b9ce-1e1179f49da1"
      },
      "subcategory": {
        "id": "6e0a5df1-2de7-40f3-8590-2f8e7bc45ef8",
        "priority": 0
      },
      "resourceRule": {
        
      },
      "visible": true,
      "status": "ACTIVATED",
      "group": {
        "id": "e97b9a4d-2fb5-48c4-ab90-3fd6dd9dfd3e"
      },
      "covered": true,
      "parkingSlotSize": "BIG",
      "electricCharger": true,
      "electricChargerExternalUrl": "https://exampleExternalURL.com"
    },
    {
      "id": "e1a7645b-b9ac-48d6-b3f0-57fa9576273f",
      "name": "B-S1-PARK-4",
      "posterCode": "B-S1-PARK-4",
      "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
      "mapCoordinates": {
        "topLeftX": 146,
        "topLeftY": 313,
        "bottomRightX": 171,
        "bottomRightY": 338
      },
      "approachable": false,
      "floor": {
        "id": "b60c8462-0c40-4f61-b9ce-1e1179f49da1"
      },
      "subcategory": {
        "id": "6e0a5df1-2de7-40f3-8590-2f8e7bc45ef8",
        "priority": 0
      },
      "resourceRule": {
        
      },
      "visible": true,
      "status": "ACTIVATED",
      "group": {
        "id": "e97b9a4d-2fb5-48c4-ab90-3fd6dd9dfd3e"
      },
      "covered": true,
      "parkingSlotSize": "BIG",
      "electricCharger": true,
      "electricChargerExternalUrl": "https://exampleExternalURL.com"
    }
  ]
}