Bookker API Documentation logo Bookker API Documentation

Edición de reservas

Última modificación: 24/10/2022

Editar reserva de puesto

Intenta actualizar la reserva de puesto del usuario con los nuevos datos.

Campos que se pueden modificar:

Acceso al edificio

Dentro de la información de la reserva hay un campo llamado “buildingAccessStatus”, que indica si se ha concedido al usuario acceso al edificio para esa reserva.

Este campo tiene tres posibles valores:

Request

HTTP request
PUT /api/v1/users/me/bookings/workstations/{bookingId}
PUT /api/v1/users/{userId}/bookings/workstations/{bookingId}
Headers
Header Value Required
Authorization Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… true
Body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto WorkstationBooking.

Property Type Description Required
Booking WorkstationBooking Datos que se quieren modificar de la reserva. true

Response

Si se han conseguido editar la reserva, se devuelve un código 200 con la información de las misma.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "f515be12-e9b7-4415-9c11-a6cd6ab02cd4",
    "recurrentId": "bb1f051e-cf23-4d0d-ae4a-d95814efc43d",
    "multipleBookingId": "44b41efe-d855-44a7-84e1-deed11e4c20b",
    "startDate": 1562144400000,
    "endDate": 1562148000000,
    "allDayBooking": false,
    "duration": 3600000,
    "status": "PENDING",
    "accessControl": {
        "accessControlType": "OPTIONAL",
        "checkInDate": null,
        "checkOutDate": null
    },
    "creator": {
        "id": "7eccd6ed-3faf-41de-bec1-0b8501316857",
        "name": "Aitor",
        "surname": "Gil",
        "alias": "AITORGC",
        "email": "aitor.gil@bookkercorp.com",
        "phone": "631256311",
        "organization": {
            "id": "4c6c300e-ff5a-400b-adb4-60e513e1f4ba"
        },
        "department": {
            "id": "26980ebb-0ac7-4bb0-bab1-81ed8fc07d59"
        },
        "userRule": {
            "id": "d58b188f-6ba6-48c4-9e0a-dd0ac81d4cb2"
        },
        "mobileRole": {
            "id": "5220b6a2-8920-4dae-8ff0-ba96707d439d"
        }
    },
    "organizer": {
        "id": "7eccd6ed-3faf-41de-bec1-0b8501316857",
        "name": "Aitor",
        "surname": "Gil",
        "alias": "AITORGC",
        "email": "aitor.gil@bookkercorp.com",
        "phone": "631256311",
        "organization": {
            "id": "4c6c300e-ff5a-400b-adb4-60e513e1f4ba"
        },
        "department": {
            "id": "26980ebb-0ac7-4bb0-bab1-81ed8fc07d59"
        },
        "userRule": {
            "id": "d58b188f-6ba6-48c4-9e0a-dd0ac81d4cb2"
        },
        "mobileRole": {
            "id": "5220b6a2-8920-4dae-8ff0-ba96707d439d"
        }
    },
    "resource": {
        "id": "01789b12-4cf5-4184-a8ce-c958f8924402",
        "name": "Puesto #2",
        "posterCode": "C07P2",
        "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
        "phone": "941987789",
        "mapCoordinates": {
            "topLeftX": 441,
            "topLeftY": 3226,
            "bottomRightX": 489,
            "bottomRightY": 3274
        },
        "approachable": true,
        "floor": {
                    "id": "14ab4017-1261-46ff-af05-eadf5d3d69e8",
                    "name": "Planta 1",
                    "floorNumber": 1,
                    "image": "8aee218a-fce2-4900-9410-00f485a2729e/buildings/758a81f3-f171-404b-b48c-c922828aed49/floors/14ab4017-1261-46ff-af05-eadf5d3d69e8/maps/40d25abc74f043f4afff218f02d2e024.png",
                    "building": {
                        "id": "758a81f3-f171-404b-b48c-c922828aed49",
                        "name": "Jupiter Building",
                        "address": {
                            "country": "ES",
                            "city": "Madrid",
                            "address": "Avenida Gran Vía, 85",
                            "coordinates": null
                        },
                        "organization": {
                            "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                        },
                        "timezone": "Europe/Madrid",
                        "status": "ACTIVATED"
                    },
                    "status": "ACTIVATED",
                    "type": "OFFICE",
                    "visible": true
                },
                "subcategory": {
                    "id": "072ac366-1c4f-4995-af07-1a111f8fcc12",
                    "name": "Sala de reuniones",
                    "category": "SPACE",
                    "organization": {
                        "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                    },
                    "deleteHistorial": false,
                    "hideBookings": false,
                    "canBeSearched": true
                },
        "visible": true
    },
    "resourceType": "WORKSTATION",
    "buildingAccessStatus": "PENDING"
}

Editar reserva de espacio

Intenta actualizar la reserva de espacio del usuario con los nuevos datos.

Hay dos tipos de edición de reserva de espacio:

Acceso al edificio

Dentro de la información de la reserva hay un campo llamado “buildingAccessStatus”, que indica si se ha concedido al usuario acceso al edificio para esa reserva.

Este campo tiene tres posibles valores:

¡IMPORTANTE!

Es importante que si se trata de una reserva de espacios de trabajo se añada la cabecera "user-access-token" con el token de acceso de Microsoft del usuario (en caso de estar logueado en Microsoft).
¡Importante!

Las reservas de espacios que tengan el parámetro isExternalOrganizer a true NO se podrán ni editar, ni cancelar, ni hacer check-out.

Campos que se pueden modificar:

Campo Descripción PUT PATCH
startDate Fecha de incio en milisegundos. No
endDate Fecha de fin en milisegundos. No
importance Importancia de la reserva (LOW, NORMAL, HIGH).
subject Título o asunto de la reserva.
bodyType Tipo del cuerpoo descripción de la reserva (TEXT, HTML).
content Cuerpo o descripción de la reserva.
internalAttendees Invitados internos.
externalAttendees Invitados externos a la plataforma Bookker.
sipAddress Dirección SIP asociada.

Request

HTTP request
DEPRECATED PUT /api/v1/users/me/bookings/spaces/{bookingId}
DEPRECATED PUT /api/v1/users/{userId}/bookings/spaces/{bookingId}
PATCH /api/v1/users/me/bookings/spaces/{bookingId}
PATCH /api/v1/users/{userId}/bookings/spaces/{bookingId}
Headers
Header Value Required
Authorization Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… true
user-access-token eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… false
Body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto SpaceBooking.

Property Type Description Required
Booking SpaceBooking Datos que se quieren modificar de la reserva. true

Response

Si se han conseguido editar la reserva, se devuelve un código 200 con la información de las misma.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "30b234c0-c148-4673-9a08-179eacf5db40",
    "startDate": 1562835600000,
    "endDate": 1562837400000,
    "duration": 1800000,
    "status": "PENDING",
    "accessControl": {
        "accessControlType": "OPTIONAL",
        "checkInDate": null,
        "checkOutDate": null
    },
    "creator": {
        "id": "7eccd6ed-3faf-41de-bec1-0b8501316857",
        "name": "Aitor",
        "surname": "Gil",
        "alias": "AITORGC",
        "email": "aitor.gil@bookkercorp.com",
        "phone": "631256311",
        "organization": {
            "id": "4c6c300e-ff5a-400b-adb4-60e513e1f4ba"
        },
        "department": {
            "id": "26980ebb-0ac7-4bb0-bab1-81ed8fc07d59"
        },
        "userRule": {
            "id": "d58b188f-6ba6-48c4-9e0a-dd0ac81d4cb2"
        },
        "mobileRole": {
            "id": "5220b6a2-8920-4dae-8ff0-ba96707d439d"
        }
    },
    "organizer": {
        "id": "7eccd6ed-3faf-41de-bec1-0b8501316857",
        "name": "Aitor",
        "surname": "Gil",
        "alias": "AITORGC",
        "email": "aitor.gil@bookkercorp.com",
        "phone": "631256311",
        "organization": {
            "id": "4c6c300e-ff5a-400b-adb4-60e513e1f4ba"
        },
        "department": {
            "id": "26980ebb-0ac7-4bb0-bab1-81ed8fc07d59"
        },
        "userRule": {
            "id": "d58b188f-6ba6-48c4-9e0a-dd0ac81d4cb2"
        },
        "mobileRole": {
            "id": "5220b6a2-8920-4dae-8ff0-ba96707d439d"
        }
    },
    "resource": {
        "id": "b5fcf35f-bba2-4050-a246-631dac18e014",
        "name": "Despacho principal",
        "posterCode": "D01P3",
        "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
        "phone": "941827392",
        "mapCoordinates": {
            "topLeftX": 803,
            "topLeftY": 685,
            "bottomRightX": 1042,
            "bottomRightY": 894
        },
        "approachable": true,
        "floor": {
                    "id": "14ab4017-1261-46ff-af05-eadf5d3d69e8",
                    "name": "Planta 1",
                    "floorNumber": 1,
                    "image": "8aee218a-fce2-4900-9410-00f485a2729e/buildings/758a81f3-f171-404b-b48c-c922828aed49/floors/14ab4017-1261-46ff-af05-eadf5d3d69e8/maps/40d25abc74f043f4afff218f02d2e024.png",
                    "building": {
                        "id": "758a81f3-f171-404b-b48c-c922828aed49",
                        "name": "Jupiter Building",
                        "address": {
                            "country": "ES",
                            "city": "Madrid",
                            "address": "Avenida Gran Vía, 85",
                            "coordinates": null
                        },
                        "organization": {
                            "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                        },
                        "timezone": "Europe/Madrid",
                        "status": "ACTIVATED"
                    },
                    "status": "ACTIVATED",
                    "type": "OFFICE",
                    "visible": true
                },
                "subcategory": {
                    "id": "072ac366-1c4f-4995-af07-1a111f8fcc12",
                    "name": "Sala de reuniones",
                    "category": "SPACE",
                    "organization": {
                        "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                    },
                    "deleteHistorial": false,
                    "hideBookings": false,
                    "canBeSearched": true
                },
        "visible": true,
        "capacity": 30
    },
    "resourceType": "SPACE",
    "buildingAccessStatus": "PENDING",
    "sipAddress": "Dirección SIP asociada"
}

WorkstationBooking

{
    "startDate": 1562407200000,
    "endDate": 1762409000000,
    "allDayBooking": false
}

SpaceBooking

{
       "startDate": 1562067600000,
        "endDate": 1562070010000,
        "importance": "NORMAL",
        "subject": "TITULO ACTUALIZADO",
        "body": {
            "content": "Uy esto no parece HTML",
            "bodyType": "HTML"
        },
        "internalAttendees": [
            {
                "type": "REQUIRED",
                "user": {
                    "id": "fa9d9890-e9e7-4ad9-82fd-572ae925f905"
                }
            }
        ],
        "externalAttendees": [
            {
                "type": "OPTIONAL",
                "email": "usuarioexterno1@gmail.com"

            },
            {
                "type": "OPTIONAL",
                "email": "usuarioexterno2@gmail.com"

            }
        ],
        "sipAddress": "Dirección SIP Address"

    }