Meldingstjener API
Her beskrives underlaget for å ta i bruk Meldingstjener API, inkludert forberedelser i Adresseregisteret og HelseID selvbetjening, referanser til HelseID kode-eksempler og utvidede beskrivelser av de tilgjengelige API-endepunktene.
Overordnet beskrivelse
Meldingstjener REST APIet tilbyr endepunkter for sending, mottak, kvitering og statussjekk for standardiserte meldinger.
API-definisjonen finnes også her.
Forberedelser i Adresse-registeret
For å sende meldinger gjennom APIet må Meldingstjeneren ta over
meldingstjener-ansvaret fra API-brukeren. Det vil si at Meldingstjeneren
må kunne hente meldinger fra og sende meldinger til EDI på vegne av
API-brukeren. For å unngå en uhåndterlig mengde EDI-adresser, vil derfor
EDI-adressen til API-brukere byttes ut med Meldingstjenerens. Det samme
gjelder krypterings og signerings-sertifikater.
Figur 5 Endringer i Adresseregisteret
Forberedelser i HelseID selvbetjening
For å kunne sende og motta meldinger (/Messages-endepunktene) må klienten autentisere seg med HelseID. Man må derfor opprette en klientkonfigurasjon med HelseIDs selvbetjening som under er illustrert med en utviklingskonfigurasjon.
Figur 6 Klientkonfigurasjon i HelseID selvbetjening
Denne konfigurasjonen vil gi API-brukeren de delene med informasjon som trengs for å be om et accesstoken. I hovedsak en klient-Id og en nøkkel som kan lastes ned. For å be om et accesstoken har HelseID tilgjengeliggjort en del eksempel-kode. Denne kan nås her: https://github.com/NorskHelsenett/HelseID.Samples. Apiet bruker client credentials som betyr at det er klienten som autentiseres og ikke en pålogget bruker.