REST API und Integrationen
Eine dokumentierte REST API, mit den Regeln des Buchungsformulars
Alles, was WBS im Web zeigt, steht anderen Systemen über eine dokumentierte REST API, Version 2, unter https://wise-tt.com/api/v2/ zur Verfügung - nur HTTPS, JSON in UTF-8.
Zugriff
- Integrationskonten werden von Wise Technologies ausgestellt und sind auf die Einrichtung beschränkt; ein Bearer-Token gilt 24 Stunden
- Das Buchen im Namen einer anderen Person braucht deren eigene Anmeldung - jede Regel des Webs gilt unverändert: Raumrechte, Genehmigung, Besitz
- ETags für das Caching, Cross-Origin-Aufrufe nur für registrierte Origins, Anmeldung mit Ratenbegrenzung
Buchungs-Endpunkte
| Endpunkt | Zweck |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Räume mit Code, Sitzplätzen, E-Mail und Ausstattung; das Vokabular der Ausstattung. |
GET /v2/reservation-types | Die Buchungstypen: ID, Name, Farbe, öffentlich. |
GET /v2/tutor-rooms | Welche Räume eine Person buchen darf. |
GET /v2/free-busy | Die Verfügbarkeitsprüfung: jeder Termin eines Musters, frei oder belegt, mit Vorschlägen. |
GET /v2/reservations | Eigene Buchungen oder die der ganzen Einrichtung für das Buchungsbüro; Suche, Filter, Seitenwechsel. |
POST / PUT / DELETE /v2/reservations | Buchungen anlegen, ändern und stornieren - dieselben Regeln wie im Formular. |
POST /v2/reservations-approve, -deny | Die Genehmigungsentscheidungen, mit dem Brief. |
GET /v2/schedule, GET /v2/event | Alles, was in einem Zeitraum gebucht ist - ein Raum, eine Person oder die ganze Einrichtung. |
Ablehnungen, die sagen warum
Jede Ablehnung trägt einen Code und einen Satz: 403 room_not_allowed nennt die Räume, die die Person buchen darf; 409 overlap liefert die kollidierenden Termine und die Alternativen. Die vollständige Referenz ist das Handbuch der Wise REST API.
Weitere Integrationen
| Mit | Wie |
|---|---|
| Outlook-, Google-, Apple-Kalender | iCalendar-Abonnements für jeden Raum, jede Person oder jede Auswahl. |
| Microsoft 365 / Entra ID | Anmeldung der Mitarbeitenden - siehe Anmeldung mit Microsoft 365. |
| Teams, Zoom und andere Meeting-Tools | Online-Meeting-Links, die an Buchungen oder Räume angehängt werden; ein von einer Person eingetippter Link wird nie überschrieben. |
| Die Website der Einrichtung | Die Raumübersicht und die Buchungen des Tages in einem iframe; Links zu jeder Ansicht. |
| Flurbildschirme | Signage-Displays in jedem Browser. |
| Verzeichnisse und SSO | Microsoft 365; LDAP und Shibboleth auf Anfrage. |
| Tabellenkalkulationen | Excel-Export jedes Berichts; Räume und Personen werden zu Beginn aus einer Tabelle importiert. |
WBS mit Ihren eigenen Räumen sehen
Vereinbaren Sie eine Online-Präsentation. Wir richten Ihre Räume und Ihre Buchungsregeln ein, und eine neue Einrichtung ist meist innerhalb weniger Tage live.