docs |
||
... | ||
eksempelkode | ||
readme.md | ||
dodsfall.md | ||
dodsarsak_med_nin.md | ||
dodsarsak_uten_nin.md | ||
tilleggsmelding.md | ||
annullering.md | ||
correlationid |
Overordnet
Illustrerer en forenklet flyt for å melde dødsfall og dødsårsak på en død person.
Tilgang
Tilgang til API-et krever Helsenett-tilknyttning i produksjon og stage/QA, men testmiljøet er åpent på internett. Store deler av API-et er beskyttet av HelseID og krever et JWT som Bearer i Authorization header.
Siden det kun er en lege som har lov å melde dødsfall og dødsårsak, krever API-et et access token med personinfo. Det vil si at ren maskin-til-maskin autentisering ikke er nok. Man må ha et access token fra en brukerpålogging via HelseID.
Man må ha et token som har:
Claims
helseid://claims/identity/pid
- hvor NIN/PID til innlogget lege.helseid://claims/identity/pid_pseudonym
- pseudonymet til legens NIN/PID.helseid://claims/hpr/hpr_number
- hvor HPR-nummeret for helsepersonell.helseid://claims/identity/security_level
- 3 og høyere ellerhelseid://claims/identity/assurance_level
med verdi susbstantial og høyere.name
,given_name
,family_name
,middle_name
- standard profilinformasjon for innlogget person.client_id
- klient-id til HelseId klienten tokenet er generert fra. Default inkludert fra HelseID
Se mer om HelseID sine claims her: https://helseid.atlassian.net/wiki/spaces/HELSEID/pages/5570914/Claims
Scope
nhn:dodsmelding/api
Miljøer
Miljø | Internett | Helsenett | URL | HelseID |
---|---|---|---|---|
Test | Ja | Nei | https://api.dodsmelding.test.nhn.no | https://helseid-sts.test.nhn.no |
QA | Nei | Ja | https://api.dodsmelding.qa.nhn.no | https://helseid-sts.test.nhn.no |
Produksjon | Nei | Ja | https://api.dodsmelding.nhn.no | https://helseid-sts.nhn.no |
Testpersoner
For testmiljøet kan man bruke en person som finnes i Tenor. Disse personene vil bli godtatt i API-et for testmiljøet.
Siden testmiljøet for produsenter hos Skatteetaten ikke endrer data i Tenor, vil ikke disse endringene reflekteres i Tenor. Altså personen der vil ikke ha status som død etter man har sendt inn en dødsmelding i testmiljøet.