DifficultyMoeilijkheidsgraad: expert

API staat voor Application Programming Interface en maakt eenvoudige uitwisseling van gegevens en functionaliteit mogelijk. De Workplace API documentatie (Swagger) is beschikbaar in een apart tabblad in het GO menu.

Hoe krijg ik toegang tot de API van Workplace?

• Ga naar https://go.cobundu.com/

• Login with your credentials

The option appears only for users who have a developer or admin role assigned to them. See Roles & Profiles for more information.

Image Removed

• Inloggen met je gegevens

De optie verschijnt alleen voor gebruikers met een ontwikkelaars- of beheerdersrol. Zie Roles & Profiles voor meer informatie.

Image Added

Om de API's in je eigen projecten te gebruiken (bijvoorbeeld postman), is het misschien interessant om de swagger.json-link . As you can see in the screenshot, "latest" page opens per default, but this is of course subject to change.

te gebruiken. Zoals je in de schermafbeelding kunt zien, wordt de "nieuwste" pagina standaard geopend, maar dit kan natuurlijk veranderen.

Het gebruik van een specifieke versie heeft het voordeel dat je in de toekomst API-versies kunt vergelijken.

Testing the

De API testen:

It's possible to try out/test the Workplace API. Depending on the request, you might need to fill in some information first.

voorbeelden

Het is mogelijk om de API van Workplace uit te proberen/te testen. Afhankelijk van het verzoek moet je misschien eerst wat informatie invullen.

In de onderstaande voorbeelden wordt "locatie-ID" genoemd. Een locatie selecteren op https://go.cobundu.com/ will show the Reference, e.g. "Meeting Room wordt de referentie weergegeven, bijvoorbeeld "Vergaderzaal 1". But Maar in the Workplace de back-end , each location has a unique location van Workplace heeft elke locatie een unieke locatie-ID.

For example the Location ID for floor “2nd floor” in Spacewell Antwerp offices is “910000000004545”

Image Removed

Example 3. Reservations

To retrieve the reservations from your environment, you can use Reservations API > "get a list of bookings".
Modify dates in the search instruction and to get (filtered) reservations, each including the location ID, thus indicating which location was booked.
Enter location IDs in the search filter to get filtered data.

Bijvoorbeeld de Locatie ID voor verdieping "2e verdieping" in Spacewell Antwerpen is "910000000004545".

Image Added

Voorbeeld 3. Reserveringen

Om de reserveringen uit je omgeving op te halen, kun je Reservations API > "een lijst met reserveringen ophalen" gebruiken.
Wijzig de datums in de zoekinstructie om (gefilterde) reserveringen te krijgen, elk met de locatie-ID, om zo aan te geven welke locatie is geboekt.
Voer locatie-id's in het zoekfilter in om gefilterde gegevens te krijgen.

Concrete use case: URL

Imagine you want to push a URL to your kiosk screens to visualize Workplace live floorplan data.

Here, we suggest to provide an acces token with a URL, so that anyone with the link can see the live floorplan.

om live plattegrond te tonen

Stel je voor dat je een URL naar je kioskschermen wilt pushen om live gegevens van de Workplace plattegrond te visualiseren.

Hier stellen we voor om een toegangstoken met een URL op te geven, zodat iedereen met de link de live plattegrond kan zien.

Alternatieve methoden en veelgestelde vragen hierover vind je hier: Workplace live floorplan data visualization

The below suggested dedicated method includes web authentication De hieronder voorgestelde speciale methode omvat webauthenticatie via Rest API. This means a Workplace login + password are needed, and the API will return a JWT token which can be used to access all other API calls.

Prerequisites

• Web kiosk needs to be configured in Studio

• Per floor for which you want to set up visualization, a Workplace user is needed:

  • Workplace minimum rights/no specific role needed

  • taking into account reservation features set up for this environment

  • User name + password

• To access API: Workplace user with either Admin or Developer role

Solution

Using API to get session token

Dit betekent dat een workplace login + wachtwoord nodig zijn, en de API retourneert een JWT token dat kan worden gebruikt om toegang te krijgen tot alle andere API-aanroepen.

Vereisten

• Webkiosk moet worden geconfigureerd in Studio

• Per verdieping waarvoor je visualisatie wilt instellen, is een Workplace gebruiker nodig:

  • Minimale rechten op de workplace/geen specifieke rol nodig

  • rekening houdend met reserveringsfuncties die zijn ingesteld voor deze omgeving

  • Gebruikersnaam + wachtwoord

• Om toegang te krijgen tot API: Workplace gebruiker met een Admin of Developer rol

Oplossing

1. API gebruiken om sessietoken te krijgen

   1. Ga naar http://go.cobundu.com (user needs either Admin or Developer role) >  API

      Select

      gebruiker heeft een beheerders- of ontwikkelaarsrol nodig) > API

      1. Selecteer "auth" > /rest/latest/auth/ssosettings/{loginId} (return sso settings for the user)

      2. Provide user name

      3.  Response body will provide the host name of cobundu SSO instance that needs to be used retourneer sso-instellingen voor de gebruiker)

      4. Geef gebruikersnaam

      5. De respons geeft de hostnaam van de cobundu SSO-instantie die moet worden gebruikt (Workplace IoT Platform is available for EU and US) (could be eg  beschikbaar voor de EU en de VS) (kan bijvoorbeeld "apiUrl" zijn: https://go.eu1.cloud.cobundu.com )

      6. 

   2. Still on Nog steeds op http://go.cobundu.com (user needs either Admin or Developer role) >  API

      Select

      gebruiker heeft een beheerders- of ontwikkelaarsrol nodig) > API

      Go to

      1. Selecteer "auth" >  > /rest/latest/login (authenticate usergebruiker authenticeren)

      2. Specify username + password that will be used to access live data

      3. Change the login parameters Geef de gebruikersnaam + het wachtwoord op dat wordt gebruikt om toegang te krijgen tot live gegevens

      4. Wijzig de aanmeldingsparameters "rememberme": true, "setCookie": true

         

      5.  Response body will provide De respons bevat accessToken

      6. 

      7. Access token is ready to be used

   Prepare Web kiosk URL

   1. 1. Toegangstoken is klaar voor gebruik

2. URL voor webkiosk voorbereiden

   1. Ga naar http://go.cobundu.com (user needs either Admin or Developer role) > Kiosk ModeSelect the relevant floor > open web kioskgebruiker heeft de rol van beheerder of ontwikkelaar nodig) > Kioskmodus

   2. Selecteer de relevante verdieping > open webkiosk

   3. Web Kiosk URL will have format heeft het volgende formaat https://go.cobundu.com/kiosk/MEETING%7C1d18e8b0-48a7-464c-8813-66608b474d6d

   4. Replace root domain of the URL to indicate to the correct cloud end-point (EU or US), you'll obtain eg Vervang het hoofddomein van de URL om het juiste cloud-eindpunt (EU of VS) aan te geven, dan krijg je bijv. https://go.eu1.cloud.cobundu.com/kiosk/MEETING| ...

   5. Add suffix Voeg achtervoegsel "?jwt=" and copy/paste accessToken at the end of the toe en kopieer/plak accessToken aan het einde van de URL

   6. 

3. Access this Toegang tot deze URL (for example bijvoorbeeld in incognito mode), and the web kiosk will open on the chosen floor without asking for identification. A session refresh will run inside the application every 10 minutes.

4. After the token is obtained, there are 10 minutes to pass it in the URL to open the floor plan.

After the floor plan is loaded, further token renewal will run automatically without session loss or any manual intervention.

Limitations

• Web kiosk shows Reservation view (= combined Occupancy and Reservations data (if available))

• If browser crashes/computer is unplugged: restart the process to get a new access token

1. incognitomodus) en de webkiosk zal openen op de gekozen verdieping zonder om identificatie te vragen. Elke 10 minuten wordt een sessie vernieuwd binnen de toepassing.

   1. Nadat de token is verkregen, heb je 10 minuten om deze door te geven in de URL om de plattegrond te openen.

   2. Nadat de plattegrond is geladen, wordt het vernieuwen van de token automatisch uitgevoerd zonder sessieverlies of handmatige tussenkomst.

Beperkingen

• Webkiosk toont reserveringsweergave (= gecombineerde bezettingsgraad- en reserveringsgegevens (indien beschikbaar))

• Als browser crasht/computer is losgekoppeld: herstart het proces om een nieuw toegangstoken te krijgen

Zoek op