REST API i integracije
Dokumentirani REST API, s pravilima obrasca za rezervaciju
Sve što WBS prikazuje na webu dostupno je drugim sustavima preko dokumentiranog REST API-ja, verzija 2, na https://wise-tt.com/api/v2/ - samo HTTPS, JSON u UTF-8.
Pristup
- Račune za integraciju izdaje Wise Technologies i ograničeni su na ustanovu; bearer token vrijedi 24 sata
- Rezerviranje u nečije ime traži prijavu te osobe - sva pravila weba vrijede nepromijenjena: prava na prostorije, odobrenje, vlasništvo
- ETag-ovi za predmemoriranje, pozivi između domena samo za registrirane domene, prijava s ograničenjem broja pokušaja
Krajnje točke za rezervacije
| Krajnja točka | Svrha |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Prostorije sa šifrom, brojem mjesta, e-poštom i opremom; rječnik opreme. |
GET /v2/reservation-types | Vrste rezervacija: id, naziv, boja, javno. |
GET /v2/tutor-rooms | Koje prostorije osoba smije rezervirati. |
GET /v2/free-busy | Provjera dostupnosti: svaki datum obrasca, slobodan ili zauzet, s prijedlozima. |
GET /v2/reservations | Vlastite rezervacije, ili sve rezervacije ustanove za ured za rezervacije; pretraga, filtriranje, straničenje. |
POST / PUT / DELETE /v2/reservations | Stvaranje, izmjena i otkazivanje rezervacija - ista pravila kao obrazac. |
POST /v2/reservations-approve, -deny | Odluke o odobrenju, s pismom. |
GET /v2/schedule, GET /v2/event | Sve rezervirano u nekom razdoblju - prostorija, osoba ili cijela ustanova. |
Odbijanja koja kažu zašto
Svako odbijanje nosi šifru i rečenicu: 403 room_not_allowed navodi prostorije koje osoba smije rezervirati; 409 overlap vraća datume koji se preklapaju i alternative. Cijela referenca je priručnik Wise REST API.
Ostale integracije
| S čime | Kako |
|---|---|
| Outlook, Google, Apple kalendari | iCalendar pretplate za bilo koju prostoriju, osobu ili odabir. |
| Microsoft 365 / Entra ID | Prijava djelatnika - vidi prijava Microsoftom 365. |
| Teams, Zoom i drugi alati za sastanke | Poveznice za online sastanke priložene rezervacijama ili prostorijama; poveznica koju je upisala osoba nikad se ne prepisuje. |
| Web stranica ustanove | Pregled prostorija i današnje rezervacije u iframeu; poveznice na bilo koji prikaz. |
| Zasloni na hodnicima | Signage zasloni u bilo kojem pregledniku. |
| Imenici i SSO | Microsoft 365; LDAP i Shibboleth na zahtjev. |
| Tablice | Excel izvoz svakog izvještaja; prostorije i ljudi uvoze se iz tablice na početku. |
Pogledajte WBS s vlastitim prostorijama
Dogovorite online prezentaciju. Postavljamo vaše prostorije i vaša pravila rezervacije, a nova ustanova obično je u radu u nekoliko dana.