API-keys aanmaken in Leviy

Hier lees je meer over het gebruik van onze API.

Ga direct naar:

• API-keys beheren
• Stappen voor het aanmaken van nieuwe API-keys
• AccessToken aanvragen
• Follow-Up Requests

Om toegang te krijgen tot de diensten van Leviy moet je een authenticatieverzoek indienen. Als de inloggegevens geldig zijn, krijg je een authenticatietoken terug. Dit token gebruik je om elk verzoek aan de diensten van Leviy te ondertekenen.

Omdat het authenticatietoken na 24 uur verloopt, moet je eenmaal per dag een nieuw token genereren.

Koppel je meerdere systemen met verschillende doeleinden (bijvoorbeeld een ERP-systeem, een facturatiesysteem, een HR-systeem, een reserveringssysteem, een ziekenhuisinformatiesysteem of een ticketingsysteem)? Gebruik dan voor elk systeem een aparte API-sleutel.

API-keys beheren

API-keys beheer je via de front-end van Leviy Accounts. Hiervoor heb je een gebruikersaccount nodig met het gebruikerstype ‘Applicatiebeheerder’.

• Gebruik voor de productieomgeving van Leviy: https://accounts.leviy.com
• Gebruik voor de acceptatieomgeving van Leviy: https://accounts.accept.leviy.com

Stappen voor het aanmaken van nieuwe API-keys

1. Ga na het inloggen in Accounts naar Organisatie-instellingen.

2. Klik in de kaart Integraties op de knop API-sleutels beheren.

3. Klik op de overzichtspagina van de API-sleutels rechtsboven op de knop Nieuwe API-sleutel genereren.

4. Vul een naam in voor de nieuwe API-sleutel en klik op Genereren.

5. De API-sleutel en het Secret worden nu gegenereerd.

Let op! Bewaar het Secret direct op een veilige plek. Zodra je deze pagina sluit, wordt het Secret nooit meer getoond!

6. Klik op ‘Terug naar API-sleutels’ om de pagina te sluiten.

AccessToken aanvragen

Met de API-sleutel kun je een AccessToken aanvragen. Dit token verloopt na 24 uur, dus je moet eenmaal per dag een nieuw token genereren.

Voorbeeldverzoek

POST /oauth/access_token HTTP/1.1

Cache-Control: no-cache

Postman-Token: 842c7b4c-2ece-4eaf-abb4-2b481dcc6d0b

Host: accounts.test.leviy.com

Content-Type: application/x-www-form-urlencoded

Content-Length: 129

grant_type: "client_credentials"

client_id: "54ba34bddc3b916bc4dd5f8b560e5250"

client_secret: "7pqcd9aB412r/c3sLHgkt5ADTtmjmTt7ArgLvX28"

Voorbeeldrespons

{

"token_type":"Bearer",

"expires_in":86400,

"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI0Y2RkZTE5YTYwYjc0OTk0NWZkNDRjOGMzMWJlYmUzZiIsImp0aSI6IjAjYjM0M2NmZDZiZGU5NTkwMmRkMzA2NmU1MDViNjc2N2ZjNzU0YTNiOTdkMWVlNDdhNzUyMjkyN2QwY2ZiM2M3MDk2OTg3MzIwMzIzIiwiaWF0IjoxNjE4MzIxMzcxLCJuYmYiOjE2MTgzMjEzNzEsImV4cCI6MTYxODQwNzc3MSwic3ViIjoiIiwic2NvcGVzIjpbXX0.JL7aGZuWb-R9Uu-edVAza_qq7TZm5KMC7azgey_EUjw_P02PQAMNOku4-NxHfoOKLsedvUVG_HmJ1nImF4R7XZiV3_y2EZfKktfh6mSjlyyDkcT3-Pp1GuByc3WSQ09vjmBcoFVrnMpudMXe1ePXypZPcQY5ImlurVGlRiOHjjc"

}

Als de inloggegevens geldig zijn, ontvang je een respons met een AccessToken. Met dit token onderteken je elk verzoek aan de API.

Voer je om de paar uur API-verzoeken uit? Dan adviseren we om elke reeks verzoeken te beginnen met het eenmalig vernieuwen van het token.

Example Authorization in postman

Follow-Up Requests

Het AccessToken, te vinden in de JSON-respons als access_token, gebruik je bij vervolgverzoeken.

HTTP

GET /replace/with/api/endpoint HTTP/1.1

Authorization: Bearer <access_token>