For English click here:
Voorbeelden voor het gebruik van de FHIR API, gedocumenteerd als een Postman collectie. Importeer het JSON bestand in deze map in postman, en creëer een environment met variabelen username en password.
Het importeren van het JSON bestand kan via de knop bovenin de linker kolom:
De collectie met voorbeelden verschijnt vervolgens in de linker kolom als Voorbeelden Nationale Terminologieserver [incl authenticatie].
Er zijn twee manieren om de gebruikersnaam en het wachtwoord toe te voegen aan de collection.
- Collection variabelen
- Environment variabelen
De collection zoals die in deze repository te downloaden is, bevat een prerequest script dat de gebruikersnaam en wachtwoord uit variabelen ophaalt. Hierbij geldt dat er eerst wordt gekeken naar variabelen in de collection, en indien deze leeg of afwezig zijn, wordt gezocht in de environment. Hier onder volgt voor beide manieren een uitleg.
Wanneer je meerdere collections wilt aanmaken met verschillende requests, kan het nuttig zijn om de inloggegevens op environment-niveau te definiëren. Zo zijn deze gegevens altijd gelijk voor alle collections. Wanneer je slechts 1 collection hebt voor de Nationale Terminologieserver, is het veiliger om de inloggegevens aan de collection te hangen, zodat deze niet per ongeluk in een andere collection gebruikt kunnen worden.
-
Klik in de linker balk op de collectie Voorbeelden Nationale Terminologieserver [incl authenticatie]. Hiermee open je de instellingen van de collectie.
-
Klik op de tab Variables. Vul vervolgens je gebruikersnaam en wachtwoord in bij de juiste rij. Let op dat je de gebruikersnaam en het wachtwoord invult in de kolom current value, anders worden deze niet actief. Klik als laatste op Save om de wijzigingen op te slaan.
-
Klik op het icoon in de volgende screenshot
-
Klik op Add
-
Creëer 2 variabelen: username en password. Je kan de environment ook een naam geven via het potloodje naast 'New Environment'. Let op dat je de gebruikersnaam en het wachtwoord invult in de kolom current value, anders zijn deze niet effectief. Klik als laatste op Save om de wijzigingen op te slaan.
-
Activeer de juiste environment via het dropdown menu rechts boven in het scherm.
-
Door met de muis op het oogje in deze screenshot te klikken verschijnen de actieve environment variabelen. Deze zouden overeen moeten komen met de zojuist ingevulde gegevens.
Het is mogelijk om zelf nieuwe requests toe te voegen aan de collection. Zolang de request in de map Voorbeelden Nationale Terminologieserver [incl authenticatie] valt, wordt de authenticatie automatisch afgehandeld.