MyFMS APIv3 Authenticatie

MyFMS APIv3 Authenticatie

Voorwoord

Deze handleiding biedt informatie over de API3-authenticatie.
De voorwaarde voor API3-authenticatie is dat u toegang heeft tot een MyFMS-account.

In dit document gebruiken we de applicatie Postman voor Windows.
U kunt Postman vinden op de volgende webpagina. U kunt Postman ook via uw webbrowser gebruiken.
We werken met een OpenAPI / Swagger. Meer informatie is te vinden op de website die hier te vinden is.

Wij kunnen u helpen met de implementatie. Hiervoor brengen wij twee dagen consultancy in rekening. Stuur een e-mail naar support@myfms.com voor meer informatie of vragen.


Een request aanmaken

Om de Accounts Endpoint te krijgen, gaat u naar de volgende webpagina:

De response ziet er ongeveer als volgt uit:

Notes
Ververs dit af en toe, aangezien het kan veranderen. Advies: maximale TTL 24 uur.

Het opvragen van de endpoints met de bovenstaande response geeft het voorbeeld hieronder.


Gebruik de token-endpoint om een access-token op te vragen.
  1. In Postman een nieuwe request aanmaken

 

Een access-token aanvragen met gebruikersgegevens

Gebruik de volgende parameters:
KEY
VALUE
client_idMyFMS.Api.V3
grant_typepassword
usernameuw gebruikersnaam
passworduw wachtwoord

Klik op Send en het resultaat zou er als volgt uit moeten zien:

Info
Gebruik het access-token in de API-calls als Bearer-token in de Authorization Header.
Notes
De refresh-token is slechts één keer te gebruiken en verloopt na 30 dagen!
Notes
Het access-token verloopt na 1 uur (3600 sec.)

De refresh-token wordt gebruikt om een nieuw access-token aan te vragen zonder opnieuw gebruikersnaam en wachtwoord te gebruiken.

 The refresh-token is used to request a new access-token without using the username and password again.

Een access-token aanvragen met een refresh-token

use following parameters
KEY
VALUE
client_idMyFMS.Api.V3
grant_typepassword
refresh_tokenrefresh-token ontvangen uit de vorige authenticatieaanvraag

Klik op Send en het resultaat zou er als volgt uit moeten zien: