Creación de reserva estándar de espacio
Última modificación: 05/12/2023
Intenta crear una / o varias reservas en el recurso elegido.
Las reservas solo se crearán si se pueden realizar todas con éxito, en el momento en el que falle una el resto no se tendrá en cuenta.
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).
Request
HTTP request
POST /api/v1/users/me/bookings/spaces/standard
POST /api/v1/users/{userId}/bookings/spaces/standard
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… | true |
| user-access-token | aZJ0eXBl0sdSldUIiwiYKsnIjoiSFM1MT… | false |
Body
En el cuerpo de la solicitud, proporcione una representación JSON del siguiente objeto:
[
{
"resource": {
"id": "b5fcf35f-bba2-4050-a246-631dac18e014"
},
"startDate": 1562230800000,
"endDate": 1562234400000,
"importance": "LOW",
"subject": "El título de la reserva",
"body": {
"content": "La descripción de la reserva bla bla bla bla bla...",
"bodyType": "TEXT"
},
"internalAttendees": [
{
"type": "REQUIRED",
"user": {
"id": "fa9d9890-e9e7-4ad9-82fd-572ae925f905"
}
}
], // Opcional
"externalAttendees": [
{
"type": "OPTIONAL",
"email": "usuarioexterno1@gmail.com"
},
{
"type": "OPTIONAL",
"email": "usuarioexterno2@gmail.com"
}
], // Opcional
"createOnlineMeeting": true, // Este campo es opcional. Si no se envía se interpretará como "false"
"sipAddress": "Dirección SIP asociada"
}
]
Response
Si se han conseguido crear las reservas, se devuelve un código 201 con la información de las mismas.
Body
HTTP/1.1 201 CREATED
Content-type: application/json
{
"bookings": [
{
"id": "b34d261e-4bf1-45ca-b17a-14d4663dff3e",
"startDate": 1621238400000,
"endDate": 1621242000000,
"duration": 3600000,
"status": "PENDING",
"accessControlType": "ANY",
"creator": {
"id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7",
"name": "Aitor",
"surname": "Jupiter",
"alias": "072919a68fbd42aead115dbee1b02620",
"email": "aitor.jupiter@bookker.es",
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es"
},
"organizer": {
"id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7",
"name": "Aitor",
"surname": "Jupiter",
"alias": "072919a68fbd42aead115dbee1b02620",
"email": "aitor.jupiter@bookker.es",
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
},
"userRule": {
"id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7"
},
"mobileRole": {
"id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
},
"canBeSearched": false,
"type": "BOOKKER_INTERNAL",
"userLanguage": "es"
},
"resource": {
"id": "81392b52-0de3-4177-8193-13b7da389362",
"name": "B-P1-SALA-1",
"posterCode": "B-P1-SALA-1",
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
"mapCoordinates": {
"topLeftX": 561,
"topLeftY": 695,
"bottomRightX": 621,
"bottomRightY": 755
},
"approachable": false,
"floor": {
"id": "14ab4017-1261-46ff-af05-eadf5d3d69e8",
"name": "Planta 1",
"floorNumber": 1,
"image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/floors/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,
"shifts": false
},
"resourceRule": {
"id": "5fe7c1c6-9f41-47b0-915f-65635e704463",
"advanceCheckIn": 900000,
"expirationMargin": 300000,
"startTime": 0,
"endTime": 82800000,
"maximumDuration": 82800000,
"maximumAdvance": 14,
"accessControlType": "ANY",
"requiresApproval": false,
"allDayBookings": false,
"allDayBookingsCheckInMS": 43200000
},
"visible": true,
"features": [
{
"id": "2c17a0c5-52c9-454b-838f-588901e7edf8",
"name": "Proyector",
"email": "txoflas@gmail.com",
"organization": {
"id": "8aee218a-fce2-4900-9410-00f485a2729e"
}
}
],
"capacity": 1
},
"supervisedBooking": {},
"subject": "",
"body": {
"content": "",
"bodyType": "TEXT"
},
"importance": "LOW",
"resourceType": "SPACE",
"buildingAccessStatus": "PENDING"
}
]
}