Een applicatiewachtwoord aanmaken voor de TOPdesk API

Waarom een applicatiewachtwoord?

Een applicatiewachtwoord is een apart wachtwoord dat alleen voor de API werkt. Je kunt er per app een aanmaken en het intrekken zonder dat de operator zijn gewone wachtwoord hoeft te wijzigen. Gaat er een telefoon kwijt, dan trek je alleen dat ene wachtwoord in.

Het gewone inlogwachtwoord werkt bewust niet voor de REST API. Wie dat toch probeert, krijgt een 401 terug — de meest gemaakte fout.

Stap 1: geef de operator API-rechten

Een applicatiewachtwoord kan alleen aangemaakt worden door een operator die REST API-toegang heeft. Dat regel je in de permissiegroep (of rol) van de operator.

1. Open in TOPdesk de permissiegroep of rol van de operator.
2. Zet het recht voor het gebruik van de REST API aan.
3. Controleer ook de rechten op de modules die je wilt gebruiken: voor AssetSpot is dat in elk geval Asset Management (lezen en wijzigen), en voor meldingen Incidentbeheer.
4. Sla op. De operator moet soms opnieuw inloggen voordat het recht werkt.

Stap 2: maak het applicatiewachtwoord aan

1. Log in als de operator en open Mijn instellingen (klik op je naam).
2. Ga naar Applicatiewachtwoorden en kies Toevoegen.
3. Geef het een herkenbare naam, zoals ‘AssetSpot – iPhone Jan’, en kies eventueel een vervaldatum.
4. Kopieer het wachtwoord meteen. TOPdesk laat het maar één keer zien.

Stap 3: inloggen in de app

In AssetSpot vul je drie dingen in: de URL van je omgeving (bijvoorbeeld jouworganisatie.topdesk.net), de loginnaam van de operator en het applicatiewachtwoord. De app bewaart ze versleuteld op het toestel.

Foutmelding? Zo lees je een 401

Een 401 betekent ‘inloggegevens afgewezen’. TOPdesk geeft daarbij geen reden, dus loop deze lijst af:

• Gewoon wachtwoord in plaats van applicatiewachtwoord — verreweg de meest voorkomende oorzaak.
• Weergavenaam of e-mailadres in plaats van de loginnaam — gebruik de TOPdesk-loginnaam van de operator.
• Wachtwoord verlopen of ingetrokken — maak een nieuwe aan.
• Account alleen voor SSO — zonder applicatiewachtwoord kan zo'n account niet via de API inloggen.
• Operator geblokkeerd — na te veel mislukte pogingen blokkeert TOPdesk de operator. Dan blijft het 401 geven, ook als alles inmiddels klopt. Laat de blokkade opheffen.

Krijg je een 403 bij een specifieke actie, zoals het wijzigen van een asset? Dan is het inloggen gelukt, maar mist de operator rechten op die module.

Klaar? Dan ben je binnen een minuut aan het scannen. Lees verder in hoe het werkt of ga direct naar downloaden.