1 Metodens formål
2 Detaljert dokumentasjon av metoden
- 2.1 Autentisering og autorisasjon
- 2.2 HTTP verb
- 2.3 Request
- 2.4 Response
- 2.5 Swagger
- 2.6 Miljøer
- 2.7 Terms and Conditions
- 2.8 Quick Start
  - 2.8.1 Request (eks.)
  - 2.8.2 Response (eks.)
3 Feilmeldinger

API-navn	DigitaltAktiv
Metode/funksjon	DigitaltAktivOmraadeliste - Erstattet av HelsenorgeAktivSjekken
Endepunkt	https://{BaseUrl)/digitaltaktiv/v1/DigitaltAktivOmraadeliste
Funksjonelt område	Digitalt aktiv
API-versjon og dato publisert	v1 Apr 20, 2022
Status	I Drift Avvikles
API-dokumentasjon sist endret	Jul 4, 2022
Teknologi	REST

Metodens formål

NB! Denne metoden skal ikke tas i bruk av nye integrasjoner, og eksisterende bruk bør erstattes av: HelsenorgeAktivSjekken

Metoden kan brukes av eksterne aktører for å undersøke om en liste med innbyggere er aktive på Helsenorge eller ikke. Basert på svaret, kan det eksterne systemet vurdere om det kan og bør kommunisere med innbyggerne via Helsenorge og/eller om det må benytte alternative kanaler. Metoden kan benyttes dersom man ønsker å lagre innbyggers digitale status i eget system.

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: 01 - System til System

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.
Header	Content-Type	application/json	Parametere i body er JSON
Body	Liste med fnr	string	En liste med fødselsnummer el. d-nummer (11 siffer), for de innbyggere man ønsker å kontrollere digital aktiv status for. NB! Der er satt en begrensning på maksimalt 1.000 fødselsnummer i samme API-kall.
	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 12-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

digitalAktivListe

liste

Liste med innbyggeres fødselsnummere og tilhørende digital aktiv status

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>/DigitaltAktivOmraadeliste

Oversikt over tilgjengelige miljøer finnes her: Testmiljøer og endepunkter

Terms and Conditions

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

Beskriv eventuelle ytterligere detaljer her.

Quick Start

Request (eks.)

Header:

Body:

{
  "fnrListe": [
    "07118600295",
    "13116900216"
  ],
  "omraade": "1"
}

Response (eks.)