Als je een integratie bouwt met deskbird, kun je met onze Public API gegevens zoals boekingen, gebruikers, groepen, resources, planning en meer ophalen en beheren.
👉 Voor volledige technische documentatie, ga naar onze Developer Hub:
https://developer.deskbird.com
1. Beschikbare use cases
Met de deskbird API kun je boekings- en aanwezigheidsgegevens koppelen aan je bestaande werkplekhulpmiddelen om workflows te automatiseren, eigen dashboards te bouwen en handmatig werk te verminderen. Hieronder vind je een paar populaire voorbeelden waarmee klanten direct operationele waarde en een betere medewerkerservaring creëren.
- Integratie van toegangscontrole: Geef automatisch toegang tot gebouwen of zones (en trek deze in) op basis van bureau- of vergaderruimteboekingen — zo hebben medewerkers altijd de juiste toegang op het juiste moment, zonder handmatige lijsten.
- Automatisering van parkeerplaatsboekingen: Laat boekingen automatisch vrijgeven of inchecken via badge-scans of HRIS-gegevens.
- Digitale bewegwijzering & kantoor dashboards: Toon live beschikbaarheid en "wie is er vandaag op kantoor" op schermen of intranetpagina's — zo kunnen teams makkelijker hun kantoordagen plannen en snel een plek vinden.
- Schoonmaak & diensten op basis van vraag: Gebruik daadwerkelijke gebruiksdata (bijv. ingecheckte boekingen) om alleen die gebieden schoon te maken en te servicen die echt gebruikt zijn — zo voorkom je onnodige schoonmaakrondes en focus je op wat telt.
- Inzichten in no-shows (door ontbrekende check-in) / ghost bookings: Analyseer boekings- versus incheckpatronen om no-shows en ongebruikte capaciteit te signaleren — en gebruik deze inzichten om ruimteplanning en boekingsregels te verbeteren.
- "Vind mijn team"-widgets: Toon eenvoudig de aanwezigheid van je team in tools zoals je intranet of samenwerkingsplatform — zo kunnen medewerkers zien wanneer collega's ter plaatse zijn gepland.
- Geavanceerde analyses: Koppel aan BI-tools zoals PowerBI of Looker om trends in gebruik en bezetting te analyseren.
💡 Let op: Dit zijn slechts enkele voorbeelden. Deel gerust je situatie en wensen met ons — we denken graag mee over de beste integratie voor jouw behoeften.
2. Beschikbare endpoints
Voor request/response-schema's en voorbeelden, zie de Developer Hub.
Kantoordetectieregels: de endpoint Lists company network configurations geeft de netwerkinstellingen terug die jouw bedrijf gebruikt voor kantoordetectie in Werkplekintelligentie, zodat je deze kunt koppelen aan je eigen tools. Resultaten kun je filteren op kantoor en worden in pagina's geladen. Elke regel toont ook met welk ander kantoor deze conflicteert, inclusief het signaal en de waarde. Een API sleutel geeft alleen gegevens van het eigen bedrijf terug. Wil je dezelfde regels als CSV-bestand exporteren, zie dan Kantoordetectie en netwerkconfiguratie instellen voor deskbird Dock.
3. Snel aan de slag
Alle technische documentatie, authenticatie-informatie en endpoint-referenties vind je op onze Developer Hub. Je vindt daar ook voorbeeldpayloads, foutcodes en integratiegidsen.
Om een API sleutel aan te maken, ga je naar Admin > Bedrijfsinstellingen > API sleutels en klik je op Generate key (alleen Global Admins kunnen sleutels genereren). In het Generate key-venster vul je een Naam (projectnaam) in, kies je API of SCIM, selecteer je een Vervaldatum (1 jaar, 2 jaar, 3 jaar of onbeperkt), en klik je op Generate key.
Je nieuwe sleutel verschijnt in de lijst, inclusief een voorbeeld van de sleutel en details zoals Aangemaakt door, Aangemaakt op, Laatst gebruikt en Vervalt op.
Je kunt sleutels verwijderen met het prullenbak-icoon — deze actie kan niet ongedaan worden gemaakt.
đź’ˇ Let op: Als je bedrijf al HRIS-synchronisatie gebruikt voor gebruikersbeheer, kun je geen SCIM sleutels aanmaken.
4. API sleutels beheren
Global Admins kunnen het volledige beheer van publieke API sleutels uitvoeren, inclusief aanmaken, vervaldatum instellen en monitoring.
Geen limiet op API sleutels
Er is geen limiet aan het aantal publieke API sleutels dat je kunt genereren. Maak er zoveel aan als je nodig hebt voor je integraties.
Vervaldatum instellen
Bij het genereren van een sleutel kun je kiezen uit de volgende periodes voor de vervaldatum:
- 1 jaar
- 2 jaar
- 3 jaar
- Onbeperkt
Vervaldatum-herinneringen per e-mail
deskbird stuurt automatisch herinneringsmails voordat een API sleutel verloopt:
- 3 maanden voor de vervaldatum
- 2 weken voor de vervaldatum
De herinnering wordt gestuurd naar degene die de sleutel heeft aangemaakt, zolang dat account nog actief is. Is het account van de maker niet meer actief, dan ontvangen alle Global Admins de e-mail.
5. Hulp nodig?
Heb je een specifieke use case in gedachten? Weet je niet zeker of iets mogelijk is?
👉 Neem contact op via support@deskbird.com. We helpen je graag met het uitdenken van de integratie.