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:
- startDate: Fecha de inicio.
- endDate: Fecha de fin.
- allDayBooking: Indica si la reserva es para todo el día o no.
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:
- PENDING: La reserva está pendiente de la aprobación o denegación de acceso.
- GRANTED: Se le ha concedido acceso al edificio.
- DENIED: Se ha rechazado el acceso al edificio.
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:
- DEPRECATED - PUT: Actualiza la reserva completamente lo que obliga a recalcular las reglas del usuario y del recurso.
- PATCH: Actualiza parcialmente la reserva no siendo necesario recalcular las reglas del usuario ni del recurso.
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:
- PENDING: La reserva está pendiente de la aprobación o denegación de acceso.
- GRANTED: Se le ha concedido acceso al edificio.
- DENIED: Se ha rechazado el acceso al edificio.
¡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. | Sí | No |
| endDate | Fecha de fin en milisegundos. | Sí | No |
| importance | Importancia de la reserva (LOW, NORMAL, HIGH). | Sí | Sí |
| subject | Título o asunto de la reserva. | Sí | Sí |
| bodyType | Tipo del cuerpoo descripción de la reserva (TEXT, HTML). | Sí | Sí |
| content | Cuerpo o descripción de la reserva. | Sí | Sí |
| internalAttendees | Invitados internos. | Sí | Sí |
| externalAttendees | Invitados externos a la plataforma Bookker. | Sí | Sí |
| sipAddress | Dirección SIP asociada. | Sí | Sí |
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"
}