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:

https://api.myfms.com/v3/auth/DiscoveryEndpoint

De response ziet er ongeveer als volgt uit:

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

   • Als requestmethode selecteren we: POST

   • Vul de token-endpoint in die u heeft ontvangen uit de openid-configuratie:
     
     https://accounts.myfms.com/connect/token

   • Gebruik als Body: x-www-form-urlencoded

 

Een access-token aanvragen met gebruikersgegevens

Gebruik de volgende parameters:

KEY	VALUE
client_id	MyFMS.Api.V3
grant_type	password
username	uw gebruikersnaam
password	uw wachtwoord

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

Gebruik het access-token in de API-calls als Bearer-token in de Authorization Header.

De refresh-token is slechts één keer te gebruiken en verloopt na 30 dagen!

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_id	MyFMS.Api.V3
grant_type	password
refresh_token	refresh-token ontvangen uit de vorige authenticatieaanvraag

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

• Related Articles

• MyFMS EasyPlug 4G handleiding

  MyFMS EasyPlug 4G De MyFMS EasyPlug 4G kan ingezet worden voor voertuigen die voor een korte tijd ingezet worden. Denk hierbij aan huur auto's, voorloop auto's, etc. MyFMS EasyPlug 4G heeft geen certificering vanuit het keurmerk ...

• MyFMS inloggen / wachtwoord vergeten.

  MyFMS-account activeren en wachtwoord herstellen Inleiding Wanneer een beheerder een MyFMS-account voor u heeft aangemaakt, ontvangt u automatisch een e-mail van MyFMS. Volg de instructies in deze e-mail om uw account te activeren. Heeft u uw account ...

• MyFMS SmartPlug handleiding

  MyFMS SmartPlug De MyFMS SmartPlug kan ingezet worden voor voertuigen die voor een korte tijd ingezet worden. Denk hierbij aan huur auto's, voorloop auto's, etc. De MyFMS SmartPlug heeft geen certificering vanuit het keurmerk ritregistratiesystemen. ...

• Kalibratie kilometerstand via MyFMS App

  Inleiding Het voertuig maakt gebruik van bepaalde sensoren om de verplaatsing vast te stellen. De kilometerverplaatsing wordt op twee manieren berekend. Deze manieren verschillen en daarom is de kalibratie van de kilometerstand noodzakelijk om te ...

• Gebruik DESFire tag i.c.m. MyFMS Smart reader

  Inleiding Voor het identificeren van een bestuurder of passagier zetten we de MyFMS Smartreader in i.c.m. een (bedrijfs) pas of druppel. De MyFMS Smartreader leest alle passen of druppels waarin een MIFARE Classic chip verwerkt is ongeacht of deze ...