API REST e integraciones
Una API REST documentada, con las reglas del formulario de reserva
Todo lo que WBS muestra en la web está disponible para otros sistemas mediante una API REST documentada, versión 2, en https://wise-tt.com/api/v2/: solo HTTPS, JSON en UTF-8.
Acceso
- Las cuentas de integración las emite Wise Technologies y se limitan a la institución; un token de portador es válido 24 horas
- Reservar en nombre de alguien exige el inicio de sesión de esa persona: todas las reglas de la web se aplican sin cambios (derechos sobre las salas, aprobación, titularidad)
- ETags para el almacenamiento en caché, llamadas entre orígenes solo para orígenes registrados, inicio de sesión con límite de frecuencia
Endpoints de reserva
| Endpoint | Finalidad |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Salas con código, asientos, correo y equipamiento; el vocabulario del equipamiento. |
GET /v2/reservation-types | Los tipos de reserva: id, nombre, color, público. |
GET /v2/tutor-rooms | Qué salas puede reservar una persona. |
GET /v2/free-busy | La verificación de disponibilidad: cada fecha de un patrón, libre u ocupada, con sugerencias. |
GET /v2/reservations | Las reservas propias, o las de toda la institución para la oficina de reservas; búsqueda, filtro, paginación. |
POST / PUT / DELETE /v2/reservations | Crear, modificar y cancelar reservas, con las mismas reglas que el formulario. |
POST /v2/reservations-approve, -deny | Las decisiones de aprobación, con la carta. |
GET /v2/schedule, GET /v2/event | Todo lo reservado en un rango: una sala, una persona o toda la institución. |
Rechazos que dicen por qué
Cada rechazo lleva un código y una frase: 403 room_not_allowed nombra las salas que la persona puede reservar; 409 overlap devuelve las fechas en choque y las alternativas. La referencia completa es el manual de la API REST de Wise.
Otras integraciones
| Con | Cómo |
|---|---|
| Calendarios de Outlook, Google, Apple | Suscripciones iCalendar para cualquier sala, persona o selección. |
| Microsoft 365 / Entra ID | Inicio de sesión del personal; vea Inicio de sesión con Microsoft 365. |
| Teams, Zoom y otras herramientas de reunión | Enlaces de reunión en línea asociados a reservas o a salas; un enlace escrito por una persona nunca se sobrescribe. |
| El sitio web de la institución | La vista general de salas y las reservas del día en un iframe; enlaces a cualquier vista. |
| Pantallas de pasillo | Pantallas informativas en cualquier navegador. |
| Directorios y SSO | Microsoft 365; LDAP y Shibboleth a pedido. |
| Hojas de cálculo | Exportación a Excel de cada informe; salas y personas importadas desde una hoja de cálculo al comienzo. |
Vea WBS con sus propias salas
Reserve una presentación en línea. Configuramos sus salas y sus reglas de reserva, y una institución nueva suele estar en funcionamiento en pocos días.