TOPDESK MAGAZINE - DECEMBER 2016 11

De TOPdesk API

Naadloos integreren en zorgeloos updaten

Probleemloos integreren zonder dat er bij iedere update getest hoeft te worden: met
de nieuwe TOPdesk API kunt u dit gratis voor elkaar krijgen. Ook wanneer u TOPdesk in
combinatie met APIs van andere applicaties gebruikt. Productmanager Tom Knippenberg
legt uit waarom TOPdesk momenteel aan een API werkt, en wat u in de toekomst nog
allemaal kunt verwachten op dit gebied.
Tekst: Luke van Velthoven Fotografie: Aad Hogendoorn

Wat is de TOPdesk API?

te halen. Of denk aan een app van je eigen

De TOPdesk API kun je zien als een soort

organisatie: die kun je nu naadloos met

Dat is voor alle klanten gratis

beschikbaar?

laag om TOPdesk heen, die een vertaalslag

TOPdesk integreren.

Klopt. Onder een Fair Use Policy. Integraties

maakt voor andere applicaties die wat met de

TOPdesk-database willen doen. Hierdoor kun

die andere partijen leveren die dus

gebruikmaken van de API kunnen

regelen, zonder het risico om wat stuk te

Welke TOPdesk-modules worden

ondersteund?

maken in de databasestructuur van TOPdesk.

Op dit moment ondersteunen we uitlezen

app store, zullen integraties van partijen

En als er iets in de database van TOPdesk

en wegschrijven in Meldingenbeheer en

zoals RES komen te staan. Daarnaast kun

verandert, zorgen wij ervoor dat de API is

Wijzigingsbeheer. De module Ondersteunende

je zelf iets voor de Marketplace bouwen.

bijgewerkt zodat je oplossing gewoon blijft

bestanden ondersteunt uitlezen en op

Partnerintegraties zullen vaak wel wat

werken. Je integraties met, of add-ons voor,

sommige punten wegschrijven. Het is

kosten, maar of je je eigen oplossing gratis

TOPdesk zullen bij updates dus niet stukgaan.

je vanuit andere applicaties dingen in TOPdesk

natuurlijk wel wat kosten. Op de TOPdesk

Marketplace, een soort business-to-business

daarnaast mogelijk om informatie uit

beschikbaar stelt of niet, kun je uiteraard

We gebruiken APIs overigens al een

Reserveringenbeheer uit te lezen. Bij

zelf bepalen.

tijd in TOPdesk zelf. Zo vraagt de nieuwe

Reserveringenbeheer kun je dus aan

Selfserviceportal bepaalde informatie op via

het eerdergenoemde voorbeeld met de

APIs. Hierdoor kan de SSP precies de juiste

beschikbaarheid van ruimtes denken.

informatie opvragen zonder te hoeven weten

Bij Ondersteunende bestanden is het

Hoe krijg je iets op de TOPdesk

Marketplace?

hoe de database van TOPdesk in elkaar steekt.

bijvoorbeeld mogelijk om via de TOPdesk API

Als klanten zelfgebouwde oplossing willen

Daarnaast maakt onze app voor eindgebruikers

nieuwe gebruikers aan te maken.

delen, kunnen ze deze naar ons opsturen

natuurlijk gebruik van de TOPdesk API.

Voor welke toepassingen kun je

een API gebruiken?

voor een review. Als de code goed is, plaatsen

En in de toekomst?

we de integratie of add-on in de TOPdesk

Marketplace. We hopen dat er veel deelbare

Halverwege 2017 komt het vernieuwde Asset

gratis oplossingen komen, maar een lead fee

Management eraan, met lees- en schrijf-APIs.

is ook een optie. Dan verwijzen we klanten

Je kunt met de API dingen uitlezen uit, of

Dit levert veel interessante mogelijkheden op,

simpelweg door naar de leverancier.

wegschrijven in TOPdesk. Een goed voorbeeld

zoals het automatisch bijwerken van assets in

uit de facilitaire hoek: je zou ervoor kunnen

TOPdesk, met tools als RES of Snow Software.

zorgen dat kleine schermpjes die bij je ruimtes

Ook zou je monitoringsoftware zoals Nagios

U vindt een overzicht van alle

hangen, laten zien wanneer zon ruimte vrij

kunnen aansluiten, om continu op de hoogte

beschikbare integraties en add-ons

is. Deze info is met de API live uit TOPdesk

te blijven van storingen.

op marketplace.topdesk.com.

12 TOPDESK MAGAZINE - DECEMBER 2016

RES ONE Service Store

Waar begin je als nieuwe APIgebruiker?
Op developers.topdesk.com kun je alles
over de publieke TOPdesk APIs vinden:
documentatie, een tutorial voor nieuwe
gebruikers en een aantal showcases waarin
je de API in werking kunt zien. Denk hierbij
aan grafieken die live informatie uit een

En van de mogelijkheden die de TOPdesk API biedt, is

een koppeling met de RES ONE Service Store. Wanneer
u deze oplossing met TOPdesk koppelt, kunt u TOPdeskgebruikers veel werk uit handen nemen. RES-oprichter
en CTO Bob Janssen en Sales Engineer Dennis Ranty
over de voordelen van de koppeling.

TOPdesk-omgeving weergeven. De code van

deze showcases komt uiteraard beschikbaar
als voorbeeld. Als je al wat ervaring hebt met

RES is een Nederlands softwarebedrijf en

geval wordt er een melding geregistreerd,

APIs, kun je met de documentatie in principe

marktleider in digitale werkplektechnologie.

de zogeheten request fulfillment wordt

direct aan de slag.

Met de RES ONE Suite, bestaande uit de

automatisch in gang gezet, en de melding

RES ONE Workspace, RES ONE Automation

wordt vervolgens ook automatisch

en RES ONE Service Store, beheert,

gesloten. Dit kan voor ieder ITSM-proces

automatiseert en beveiligt RES de digitale

worden opgezet.

Wat gaat de toekomst de API

nog brengen?

werkplek onafhankelijk van de bestaande

Janssen vult aan: In principe

TOPdesk zelf en de API zijn altijd in

infrastructuur. Janssen: Een doel van

signaleert TOPdesk dus verzoeken, en

ontwikkeling. Er komen nieuwe features

onze oplossingen is dat we altijd willen

geven wij daar een passend antwoord

beschikbaar en onderliggende databases

passen in de infrastructuur die een klant al

op. De TOPdesk API is voor ons en onze

kunnen daardoor veranderen. De API blijft

heeft. Ook willen we alle IT-silos zo goed

klanten erg gemakkelijk in gebruik.

echter altijd de benodigde vertaalslag maken.

mogelijk ontsluiten met n overkoepelend

TOPdesk is daarnaast altijd bereid

Dat mag je als klant ook verwachten. Als er

systeem: van mobile device-management en

om klantverzoeken voor nieuwe

uiteindelijk een nieuwe versie van de API

desktopbeheer tot applicaties in de cloud.

toepassingsmogelijkheden met ons op te

komt, hanteren we uiteraard een zogeheten

We komen TOPdesk vaak tegen als onderdeel

pakken. Dit maakt de samenwerking erg

grace period, waarin we beide versies van de

van de infrastructuur bij onze klanten.

soepel. Ons eigen platform is bovendien

API blijven hosten. Dan heb je als TOPdesk-

Door TOPdesk via de gratis connectoren te

open, waardoor klanten zelfstandig

klant en als externe leverancier bijvoorbeeld

koppelen met de RES ONE Service Store, zijn

aan de slag kunnen met onze gratis

nog een jaar de tijd om een nieuwe versie van

veel TOPdesk-workflows te automatiseren.

connectoren, en kunnen profiteren van

je integratie te bouwen.

ons kennissysteem met best practices.

Nieuwsgierig geworden naar een voorbeeld?

Vereenvoudigd licentiebeheer

Lees hiernaast over de koppeling met de RES

Werkt de installatie van een app bijvoorbeeld

Nieuwe medewerkers

One Service Store.

niet omdat er geen licenties beschikbaar

Een ander voorbeeld van een verbinding

zijn, dan kan er automatisch een melding

tussen TOPdesk en de RES ONE Service

worden geregistreerd. Ranty leg uit: We

Store, is het zogeheten onboarding-

begrijpen hoe TOPdesk zijn processen

proces voor nieuwe medewerkers.

regelt, bijvoorbeeld in Meldingenbeheer of

Janssen: Dit is bij bijna iedere klant en

Wijzigingsbeheer. We weten daardoor bij

voor iedere afdeling verschillend. Zon

Voor meer informatie over de

welke module we moeten zijn voor zaken

proces kan soms weken duren, onder

nieuwe TOPdesk API, gaat u

als het resetten van een wachtwoord. In dat

andere doordat er veel goedkeuringen

naar api.topdesk.com.

TOPDESK MAGAZINE - DECEMBER 2016 13

bij komen kijken. Met de RES ONE Service

Store kan dat door automatisering
worden teruggebracht tot enkele uren.
Een interessant voordeel van onze
oplossing, is dat klanten de connectoren
per type medewerker kunnen inrichten,
zonder daar veel tijd in te hoeven steken.
Met de connectoren die op dit moment
beschikbaar zijn, kan RES als het ware
tegen TOPdesk praten, om bijvoorbeeld
een gebruiker aan te maken. Janssen:
In de toekomst willen we er met TOPdesk
voor zorgen dat dit tweerichtingsverkeer
wordt, zodat mutaties in TOPdesk vertaald
worden als acties in de RES ONE Service
Store. Ook willen we Middelenbeheer
ondersteunen, zodat je met behulp van
RES kunt regelen dat je CMDB altijd
up-to-date is.

De toekomstplannen van RES

We willen de komende jaren onze positie
als wereldspeler verder uitbreiden. Een
wereldspeler die IT als een dienst levert.
Of dat nu in de cloud is, on-premises of
een combinatie daarvan, dat maakt voor
ons niet uit, licht Janssen toe. Ranty: We
komen via verschillende wegen in contact
met onze klanten. Zo hebben we veel
partners die implementaties verzorgen,
maar kunnen we klanten ook zelf helpen.
We willen vooral dat iedereen geholpen
wordt door de partij die het meeste van
een klant weet.

Dennis Ranty, Sales Engineer en Bob Janssen, CTO en oprichter van RES