Gliffy | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Forretningsbehov
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
Forutsetninger & tips
Bestilling av tilgang til eksternapi, eller ved behov for opprettelse av nye installasjoner for digital aktiv sjekk, skal sendes til ide-ogbestillingsmottak@nhn.no. Fyll ut bestillingsskjema under.
Informasjon om Testmiljøer og endepunkter.
API’et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.
For å nå https://eksternapi i test-systemene våre, må NHN whiteliste IP adressen, trafikken kommer fra.
Aktør er konfigurert med en API-klient i avtalt/egnet testmiljø
API-klient er gitt tilgang til STS i context (System til System - V2)
API-klient er gitt tilgang til DigitalAktiv API
NB! DigitaltAktiv svaret fra HN inneholder ikke status på om innbygger har reservert seg mot digital kommunikasjon i DigDirs kontakt- og reservasjonsregister. Det betyr at personer kan være aktive på Helsenorge, også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt. Dette hindrer ikke digital dialog via HN (som har eget samtykke), men hindrer f.eks. videreformidling av viktige brev.
Dersom DigitaltAktivStatusEndringer sendes uten dato, vises resultat for siste 3 måneder.
Denne metoden skiller kun på område (fra forespørselen), ikke på virksomhet - mao svaret inneholder alle endringene fra hele folkeregisteret.
View file | ||
---|---|---|
|
Hva betyr det å være Digital aktiv?
Expand | ||
---|---|---|
| ||
Svaret på Digital Aktiv er ikke binært ja/nei og svaret funksjonen gir, vil avhenge av mange faktorer:
Aktiv selvBetyr at innbygger har en aktiv profil på Helsenorge og kan motta digital informasjon innenfor det området det er snakk om i det aktuelle tilfellet. Aktiv via andreBetyr at det finnes minst en annen person som har tilgang til å representere den aktuelle innbyggeren innenfor det aktuelle området på Helsenorge. Dvs. at det finnes andre som kan få tilgang til informasjon på vegne av innbyggeren og evt. utføre aktuelle handlinger på vegne av denne. Dette kan også fungere som et supplement i tillegg til informasjon som også må gis i andre kanaler for å nå innbygger direkte. Personen(-e) som kan representere andre på denne måten har fått denne tilgangen gjennom fullmakt eller fordi de har foreldreansvar for barnet det er snakk om. Tolkning av svaret på DigitaltAktivOmrådeIntegrasjonsparten er ansvarlig for å avgjøre hva som er riktig å gjøre med svarene. Aktøren må selv definere behov for å skille på erDigitaltAktivSelv eller erDigitalAktivViaAndre |
Teknisk Implementasjon
Teknologi | Dokumentasjon | Kommentar | ||||
---|---|---|---|---|---|---|
| Gir informasjon om én innbygger sin digitalt aktiv status | |||||
| Samme som over, men støtter å spørre om status på flere innbyggere i samme API-kall. | |||||
| Gir informasjon om hvilke innbyggere som har endret sin digitalt aktiv status siden angitt tidspunkt. Benyttes for store aktører (f.eks. RHF og store kommuner) der DigitaltAktivOmråde ikke er egnet å benytte direkte. | |||||
| Autorisasjon og aksesstoken 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 i “01 - System - System”. |