/postman_voorbeelden

Voorbeelden voor het gebruik van de FHIR API, gedocumenteerd als een Postman collectie.

For English click here:

postman

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.

Importeren

Het importeren van het JSON bestand kan via de knop bovenin de linker kolom:

Instellingen collection

De collectie met voorbeelden verschijnt vervolgens in de linker kolom als Voorbeelden Nationale Terminologieserver [incl authenticatie].

Toevoegen gebruikersnaam en wachtwoord

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.

Variabelen in collection toevoegen

  • Klik in de linker balk op de collectie Voorbeelden Nationale Terminologieserver [incl authenticatie]. Hiermee open je de instellingen van de collectie.

    Instellingen collection

  • 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.

    Instellingen collection

    Opslaan collection

Variabelen in environment toevoegen

  • Klik op het icoon in de volgende screenshot

    Instellingen environment

  • Klik op Add

    Toevoegen environment

  • 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.

    Aanpassen environment

  • Activeer de juiste environment via het dropdown menu rechts boven in het scherm.

    Activeren environment

  • 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.

    Controleren environment

Toevoegen nieuwe requests

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.