REST API ir integracijos
Dokumentuota REST API su rezervavimo formos taisyklėmis
Viskas, ką WBS rodo internete, kitoms sistemoms prieinama per dokumentuotą REST API, 2 versiją, adresu https://wise-tt.com/api/v2/ – tik HTTPS, JSON UTF-8 koduote.
Prieiga
- Integracijų paskyras išduoda Wise Technologies ir jos apribotos įstaiga; bearer žetonas galioja 24 valandas
- Rezervuoti kito asmens vardu galima tik su paties asmens prisijungimu – visos interneto taisyklės taikomos nepakeistos: teisės į patalpas, patvirtinimas, nuosavybė
- ETag talpyklai, tarpdomeninės užklausos tik registruotoms kilmėms, ribojamas prisijungimų dažnis
Rezervavimo galiniai taškai
| Galinis taškas | Paskirtis |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Patalpos su kodu, vietomis, el. paštu ir įranga; įrangos žodynas. |
GET /v2/reservation-types | Rezervacijos tipai: id, pavadinimas, spalva, viešumas. |
GET /v2/tutor-rooms | Kurias patalpas asmuo gali rezervuoti. |
GET /v2/free-busy | Užimtumo patikra: kiekviena šablono data, laisva ar užimta, su pasiūlymais. |
GET /v2/reservations | Savo rezervacijos arba visos įstaigos rezervacijos rezervacijų biurui; paieška, filtras, puslapiavimas. |
POST / PUT / DELETE /v2/reservations | Rezervacijų kūrimas, keitimas ir atšaukimas – tos pačios taisyklės kaip formoje. |
POST /v2/reservations-approve, -deny | Patvirtinimo sprendimai su laišku. |
GET /v2/schedule, GET /v2/event | Viskas, kas užrezervuota laikotarpiu – patalpa, asmuo ar visa įstaiga. |
Atsisakymai, kurie pasako kodėl
Kiekvienas atsisakymas turi kodą ir sakinį: 403 room_not_allowed nurodo patalpas, kurias asmuo gali rezervuoti; 409 overlap grąžina sutampančias datas ir alternatyvas. Pilna nuoroda yra Wise REST API vadove.
Kitos integracijos
| Su kuo | Kaip |
|---|---|
| Outlook, Google, Apple kalendoriai | iCalendar prenumeratos bet kuriai patalpai, asmeniui ar pasirinkimui. |
| Microsoft 365 / Entra ID | Darbuotojų prisijungimas – žr. prisijungimas per Microsoft 365. |
| Teams, Zoom ir kiti susitikimų įrankiai | Internetinių susitikimų nuorodos, pridėtos prie rezervacijų ar patalpų; žmogaus įvesta nuoroda niekada neperrašoma. |
| Įstaigos svetainė | Patalpų apžvalga ir dienos rezervacijos iframe; nuorodos į bet kurį vaizdą. |
| Koridoriaus ekranai | Informaciniai ekranai bet kurioje naršyklėje. |
| Katalogai ir SSO | Microsoft 365; LDAP ir Shibboleth pagal užklausą. |
| Skaičiuoklės | Kiekvienos ataskaitos eksportas į Excel; patalpos ir žmonės pradžioje importuojami iš skaičiuoklės. |
Pamatykite WBS su savo patalpomis
Užsisakykite internetinę prezentaciją. Sukonfigūruojame Jūsų patalpas ir rezervavimo taisykles, o nauja įstaiga paprastai pradeda veikti per kelias dienas.