Metode DigitaltAktivOmraade (erstattes av ny funksjon)

Owned by Alette N. L. Olrik (Unlicensed)
Last updated: Oct 25, 2023 by sven.christiansen
3 min read

API-navn

DigitaltAktiv

Metode/funksjon

DigitaltAktivOmraade - Erstattet av HelsenorgeAktivSjekken

Endepunkt

https://{BaseUrl)/digitaltaktiv/v1/DigitaltAktivOmraade

Funksjonelt område

Digitalt aktiv

API-versjon og dato publisert

v1 Mar 10, 2021

Status

I Drift Avvikles

API-dokumentasjon sist endret

Jul 4, 2021

Teknologi

REST

Metodens formål

NB! Denne metoden skal ikke tas i bruk av nye integrasjoner, og eksisterende bruk bør erstattes av: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2043478017

Metoden kan brukes av eksterne aktører for å undersøke om en bestemt innbygger er aktiv på Helsenorge eller ikke. Basert på svaret, kan det eksterne systemet vurdere om det kan og bør kommunisere med innbyggeren via Helsenorge og/eller om det må benytte alternative kanaler. Dersom formålet er å lagre innbyggers digitale status i eget system bør metoden bare benyttes etter at metoden DigitaltAktivStatusEndringer først er benyttet.

benytte API'et

Detaljert dokumentasjon av metoden

Autentisering og autorisasjon

Alle API’er krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken som skal være med i tjenestekallene til det enkelte API. DigitalAktiv tjenesten krever ikke at kallet utføres i context av en innlogget bruker dvs. UseCase 1 (system-til-system) beskrevet her kan benyttes: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1886191617

HTTP verb

Det skal benyttes POST og alltid https.

For å unngå at innbyggers fødselsnummer er en del av parameterne i URL’en, og dermed vil vises i browser-historikk, benyttes alltid POST med parametere i requestens body.

Request

Plassering

Navn

Type

Beskrivelse

Plassering

Navn

Type

Beskrivelse

Header

Authorization: bearer {access-token}

-

Aksess token som klienten fikk fra Helsenorge sikkerhetstjeneste etter å ha autentisert/autorisert seg mot denne.

Content-Type

application/json

Parametere i body er JSON

Body

fnr

string

Innbyggers fødselsnummer el. d-nummer (11 siffer)

 

omraade

int

Lovlige verdier (kun en av verdiene):

1 (Helseregister)

2 (Pasientjournal)

3 (Helsehjelp

4 (Forvaltning)

5 (Sekundærbruk)

6 (Ungdom, nytt område for ungdom mellom 13-16 år))

(Disse verdiene er registrert i Volven kodeverk, 7618)

Beskrivelse:
Dette representerer en logisk gruppering av tjenestene og informasjon på Helsenorge. Utgangspunktet er at den eksterne klient som benytter API'et vet hvilket tjeneste område den tjeneste man selv etterpå ønsker å benytte tilhører. Dersom man er usikker må man spørre sin kontaktperson på Helsenorge.

Beskrivelse av områdene - hva skal brukes når:

  • Helseregister – brukes for informasjon og tjenester knyttet til innbyggers innsyn og rettigheter i ulike registre 
    eks: besvare innsynsforespørsler

  • Pasientjournal – brukes for informasjon og tjenester knyttet til innbyggers personvernrettigheter i pasientjournal
    eks: besvare innsynsforespørsler

  • Helsehjelp – brukes for informasjon og tjenester knyttet til innbyggers direkte behandling, helsehjelp og forebygging og hvordan videre behandlingsløp, oppfølging og informasjon skal håndteres 
    eks: sende oppgaver, timeavtaler eller annet til innbygger ifm. pasientforløp

  • Forvaltning – brukes for informasjon og tjenester knyttet til helseforvaltning og helseøkonomiforvaltning 
    eks: sende ut vedtak

  • Sekundærbruk – brukes for informasjon og tjenester knyttet til forskning, helseundersøkelser og annen sekundærbruk 
    eks: invitere til deltakelse og sende ut informasjon fra forskningsprosjekter og helseundersøkelser. Det tas hensyn til eventuell reservasjon innbygger har gjort mot at Helsenorge benyttes som kanal for slike hendvendelser.

  • Ungdom – brukes for informasjon og tjenester som ungdommen selv kan velge å ta i bruk, uten at foreldre må samtykke til det, ut i fra GDPR og helselovgivningen eks: gi informasjon til ungdom om skolehelsetjenesten.

Response

Plassering

Navn

Type

Beskrivelse

Plassering

Navn

Type

Beskrivelse

Body

erDigitalAktivSelv

boolean

Denne vil være satt dersom innbygger er digitalt aktiv selv.

NB! Et barn < 16 år vil aldri kunne være digital aktiv selv (foreløpig, men dette vil nok komme etter hvert)

 

erDigitalAktivViaAndre

boolean

Denne vil være satt dersom innbygger er digitalt aktiv via andre, dvs det finnes minst en annen person som kan representere innbyggeren.

Dette kan være ved foreldrerepresentasjon (hvis barn < 16 år) eller ved fullmakt.

Swagger

https://eksternapi.hn.test.nhn.no/digitaltaktiv/swagger/index.html

Miljøer

Standard for hvordan URL’en til API’et vil se ut i alle miljøene: https://<miljø>/digitaltaktiv/<versjon>/DigitaltAktivOmraade

Oversikt over tilgjengelige miljøer finnes her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1552384092

Terms and Conditions

Vilkår og betingelser for bruk av API'et. Generell oversikt over alle vilkår finnes her:

Beskriv eventuelle ytterligere detaljer her.

Quick Start

Request (eks.)

Header:

 

Body:

{ "fnr": "07118600295", "omraade": 1 }

Response (eks.)

Body:

{ "erDigitaltAktivSelv": true, "erDigitaltAktivViaAndre": true }

Feilmeldinger

Følgende responskoder kan forventes fra Helsenorge:

Kode

Beskrivelse

Kode

Beskrivelse

200

Alt OK

400

Validering av request feiler

401

Autorisasjon er feil eller mangler

403

Tilganger mangler

500

Midlertidig feil, prøv igjen senere (fra release august 2021)

Ved HTTP-statuskoder som tilsier at det har oppstått en feil returneres også en respons med feilkode og feilmelding.

Eks:

{  "Code": "SEC-110000",  "Message": "Token is expired or invalid"}