API REST et intégrations
Une API REST documentée, avec les règles du formulaire de réservation
Tout ce que WBS montre sur le web est disponible pour d’autres systèmes grâce à une API REST documentée, version 2, à https://wise-tt.com/api/v2/ - HTTPS uniquement, JSON en UTF-8.
Accès
- Les comptes d’intégration sont délivrés par Wise Technologies et limités à l’établissement ; un jeton bearer est valable 24 heures
- Réserver au nom de quelqu’un exige la propre connexion de cette personne - toutes les règles du web s’appliquent sans changement : droits sur les salles, validation, propriété
- ETags pour la mise en cache, appels inter-origines uniquement pour les origines enregistrées, connexion limitée en fréquence
Points d’accès de réservation
| Point d’accès | Objet |
|---|---|
GET /v2/rooms, GET /v2/room-equipment | Salles avec code, places, e-mail et équipements ; le vocabulaire des équipements. |
GET /v2/reservation-types | Les types de réservation : id, nom, couleur, public. |
GET /v2/tutor-rooms | Quelles salles une personne peut réserver. |
GET /v2/free-busy | La vérification de disponibilité : chaque date d’un schéma, libre ou prise, avec des suggestions. |
GET /v2/reservations | Ses propres réservations, ou celles de tout l’établissement pour le service des réservations ; recherche, filtre, pagination. |
POST / PUT / DELETE /v2/reservations | Créer, modifier et annuler des réservations - les mêmes règles que le formulaire. |
POST /v2/reservations-approve, -deny | Les décisions de validation, avec le courrier. |
GET /v2/schedule, GET /v2/event | Tout ce qui est réservé sur une période - une salle, une personne ou tout l’établissement. |
Des refus qui disent pourquoi
Chaque refus porte un code et une phrase : 403 room_not_allowed nomme les salles que la personne peut réserver ; 409 overlap renvoie les dates en conflit et les alternatives. La référence complète est le manuel de l’API REST de Wise.
Autres intégrations
| Avec | Comment |
|---|---|
| Calendriers Outlook, Google, Apple | Abonnements iCalendar pour toute salle, personne ou sélection. |
| Microsoft 365 / Entra ID | Connexion du personnel - voir Connexion Microsoft 365. |
| Teams, Zoom et autres outils de réunion | Liens de réunion en ligne joints aux réservations ou aux salles ; un lien saisi par une personne n’est jamais écrasé. |
| Le site web de l’établissement | La vue d’ensemble des salles et les réservations du jour dans un iframe ; des liens vers n’importe quelle vue. |
| Écrans de couloir | Écrans d’affichage dans n’importe quel navigateur. |
| Annuaires et SSO | Microsoft 365 ; LDAP et Shibboleth sur demande. |
| Tableurs | Export Excel de chaque rapport ; salles et personnes importées depuis un tableur au démarrage. |
Découvrez WBS avec vos propres salles
Réservez une présentation en ligne. Nous mettons en place vos salles et vos règles de réservation, et un nouvel établissement est généralement opérationnel en quelques jours.