API REST e integrazioni
Un'API REST documentata, con le regole del modulo di prenotazione
Tutto ciò che WBS mostra sul web è disponibile per altri sistemi tramite un'API REST documentata, versione 2, all'indirizzo https://wise-tt.com/api/v2/, solo HTTPS, JSON in UTF-8.
Accesso
- Gli account di integrazione sono rilasciati da Wise Technologies e limitati all'istituzione; un token bearer è valido 24 ore
- Prenotare per conto di qualcuno richiede l'accesso della persona stessa: ogni regola del web si applica invariata (diritti sulle sale, approvazione, titolarità)
- ETag per la cache, chiamate cross-origin solo per origini registrate, accesso con limitazione della frequenza
Endpoint di prenotazione
| Endpoint | Scopo |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Sale con codice, posti, e-mail e attrezzature; il vocabolario delle attrezzature. |
GET /v2/reservation-types | I tipi di prenotazione: id, nome, colore, pubblico. |
GET /v2/tutor-rooms | Quali sale una persona può prenotare. |
GET /v2/free-busy | Il controllo della disponibilità: ogni data di uno schema, libera o occupata, con suggerimenti. |
GET /v2/reservations | Le proprie prenotazioni, o quelle di tutta l'istituzione per l'ufficio prenotazioni; ricerca, filtro, paginazione. |
POST / PUT / DELETE /v2/reservations | Creare, modificare e annullare prenotazioni, con le stesse regole del modulo. |
POST /v2/reservations-approve, -deny | Le decisioni di approvazione, con la lettera. |
GET /v2/schedule, GET /v2/event | Tutto ciò che è prenotato in un intervallo: una sala, una persona o l'intera istituzione. |
Rifiuti che dicono il perché
Ogni rifiuto riporta un codice e una frase: 403 room_not_allowed indica le sale che la persona può prenotare; 409 overlap restituisce le date in conflitto e le alternative. Il riferimento completo è il manuale dell'API REST di Wise.
Altre integrazioni
| Con | Come |
|---|---|
| Calendari Outlook, Google, Apple | Abbonamenti iCalendar per qualsiasi sala, persona o selezione. |
| Microsoft 365 / Entra ID | Accesso del personale: vedete Accesso con Microsoft 365. |
| Teams, Zoom e altri strumenti per riunioni | Link di riunioni online associati a prenotazioni o sale; un link digitato da una persona non viene mai sovrascritto. |
| Il sito web dell'istituzione | La panoramica delle sale e le prenotazioni del giorno in un iframe; link a qualsiasi vista. |
| Schermi nei corridoi | Display signage in qualsiasi browser. |
| Directory e SSO | Microsoft 365; LDAP e Shibboleth su richiesta. |
| Fogli di calcolo | Esportazione in Excel di ogni report; sale e persone importate da un foglio di calcolo all'inizio. |
Vedete WBS con le vostre sale
Prenotate una presentazione online. Configuriamo le vostre sale e le vostre regole di prenotazione, e una nuova istituzione è di solito operativa nel giro di pochi giorni.