Om meer te bereiken met LearnLinq en andere systemen, kun je gebruik maken van onze API om allerlei handige taken uit te voeren zoals het toevoegen en verwijderen van gebruikers, organisatieonderdelen en functies. In het kort: data uitwisselen met je HR systeem. 

REST API documentatie van LearnLinq

Als je meer inzicht wil hebben in de functies in onze API, kijk dan op <jouw url>/WebAPI/documentation. Bijvoorbeeld, de demo app van LearnLinq is te vinden op: https://demo.learnlinq.com. De API documentatie kun je dan bereiken via: https://demo.learnlinq.com/WebAPI/documentation. Hierin is een overzicht van alle methodes te zien die beschikbaar zijn in de API.

Toegang tot de LearnLinq API

Als je wil verbinden met de API, moet ieder verzoek geautenticeerd worden. Authenticatie is gebaseerd op een Personal Access Token. Dit Personal Acces Token bevat informatie over de gebruiker en de rechten van deze gebruiker binnen de API en is in feite een unieke sleutel. Deze Personal Access Tokens worden aangemaakt in LearnLinq en kunnen op ieder gewenst moment verwijderd (ingetrokken) worden. Nadat een Personal Acces Token is verwijderd, kan de API met dit token niet meer benaderd worden.

Een Personal Access Token aanmaken

Volg deze stappen om een Personal Access Token aan te maken:

  • Open het Instellingen menu, kies de optie Personal Acces Tokens (API). Dit menu laat alle actieve Personal Access Tokens zien.
  • Kies voor de + knop (toevoegen) om een Personal Access Token aan te maken.
  • Stel de Naam van het token in zoals deze in de lijst van actieve Tokens moet worden weergegeven.
  • Kies de Gebruiker die de eigenaar is van de sleutel. Alle wijzigingen die worden gemaakt met deze sleutel, hebben deze gebruiker als eigenaar (bijvoorbeeld RegistrationByUsername).
  • Kies de Scopes (rechten) voor dit Personal Access Token.
  • Kies voor Opslaan.

Na het opslaan wordt het Personal Access Token gegenereerd en getoond. Deze sleutel wordt niet opgeslagen in LearnLinq en wordt éénmalig bij het aanmaken weergegeven. Kopieer deze sleutel en bewaar deze sleutel zorgvuldig voor later gebruik.

Een Personal Access Token verwijderen

Na het verwijderen van een Personal Access Token, is toegang tot de API met deze sleutel niet langer mogelijk. Volg deze stappen om een token te verwijderen:

  • Open het Instellingen menu, kies de optie Personal Access Tokens (API). Dit menu laat alle actieve Personal Access Tokens zien.
  • Kies Verwijderen onder het Meer opties menu van het Personal Access Token dat je wil verwijderen.
  • Kies voor Verwijderen.

Heeft u het antwoord gevonden?