How to for utviklere / teknisk dokumentasjon

For å kunne opprette en integrasjon mot verktøykatalogen på Helsenorge må NHN registrere noen opplysninger om dere som leverandør. Dette er nødvendig for at vi skal kunne opprette en API-klient knyttet til deres organisasjonsnummer. Merk: dette må gjøres både i test og produksjon.

NHN trenger denne informasjonen:

1. Navn på API-klienten:

2. Sikkerhetssone - hvilken sone/nettverk veiledningsleverandøren sitt system er tilgjengelig på og der hvor API-klienten skal kommunisere med Helsenorge

   1. Verdi i test (velg ett alternativ):

      1. Internett

      2. Helsenett

   2. Verdi i produksjon (velg ett alternativ):

      1. Internett

      2. Helsenett

Leverandør må generere en RSA-nøkkel i riktig format og sende denne til NHN

• Se hvordan du generer en RSA-nøkkel og hvilket format den må være i her: Client Assertion – Helsenorge – Confluence (atlassian.net)

Leverandør må Informere om hvilke veiledningstjenester i testmiljøet dere skal oppdatere maskinelt (Helsenorge TEST02) og be om GUID til disse. NHN oppretter og tilordner da testdata i verktøykatalogen etter behov. Du trenger dette, i tillegg til GUID for API-klienten, i neste steg.

Når punkt 1-3 over er gjennomført oppretter NHN en API-klient som leverandøren kan benytte for integrasjon. Leverandøren får da tilsendt GUID for API-klienten, test-URL og relevante test-GUID for de veiledningstjenester leverandøren skal administrere.

Når dette er mottatt kan man gå i gang med utvikling, få på plass integrasjonen mot Helsenorge og teste mot endepunktene i testmiljøet Helsenorge TEST02.

1. Oversikt testmiljøer: Testmiljøer og endepunkter – Helsenorge – Confluence (atlassian.net)

2. Implementasjonsguide/steg for steg: 01 – System til System – V2 – Helsenorge – Confluence (atlassian.net)

3. API-dokumentasjon: Swagger UI (helsenorge.no)

Når utviklingen er gjennomført og integrasjonen er på plass, fortsett videre fra punkt 9 i den overordnede prosessen.