{BaseUrl}/verktoy/system/verktoy/v2

VerktoyId

guid

Verktøyets unike ID slik det er lagret i Verktøykatalogen

InnbyggerFnr

string

Innbyggers fødselsnummer (type string). Merk! det vil bli feilrespons dersom innbygger ikke er digitalt aktiv på Helsenorge.

AvsenderOrgNummer

string

Organisasjonsnummer til avsender av verktøyet.

AvsenderNavn

string

Navn på avsender slik den vil vises for innbygger på Helsenorge. Avsender står fritt til å angi aktuelt ‘nivå’, enten det er virksomhet, avdeling, klinikk eller en bestemt behandler.

FristDato

DateTime?

Valgfritt. Frist benyttes for å angi når oppgaven skal utføres. Hvis ikke frist angis settes den to uker frem i tid. Innbygger vil også ha mulighet til å utføre oppgaven i tre måneder etter at fristen har utløpt.

MERK! Helsenorge benytter kun angitte datoer i forretningslogikken. (Dvs. eventuell angivelse av time, minutt etc., tas ikke hensyn til)

Melding

string

Valgfritt. En tekstlig beskrivelse av oppgaven som vises til innbygger. Brukes for å forklare hvorfor innbygger har fått verktøyet og motivere de til å ta det i bruk. Vises i tillegg til en standardtekst om at innbygger har mottatt en oppgave om å ta i bruk et verktøy på oppfordring fra helseaktør/behandler. Maks. 1500 tegn.

JSON:

PseudoId er pasientens generete pseudo-id på helsenorge for den API-klienten som eier verktøyet.

• Lettvekts-API som er enkelt å implementere og ta i bruk. Mye av logikken og kompleksiteten er standardisert og håndteres av Helsenorge.

• Kan kun implementeres og brukes for å sende et bestemt verktøy (som regel fra behandlerdelen av verktøyet selv)

• Støtter retur av pseudo-ID for eldre integrasjonsformer

• Standardisert FHIR-API med mye fleksibilitet og valg knyttet til forretningslogikk og bruk som kan brukes til å sende ulike typer av oppgaver til innbyggere. Det å starte å bruke et verktøy er en spesifikk oppgavetype blant mange andre som også tilbys.

• Enkelt å ta i bruk hvis løsningen allerede sender ut oppgaver i andre sammenhenger, men høy brukerterskel ved førstegangs implementasjon. Dermed mest egnet for større aktører og systemer som har behov for å sende ut flere typer av oppgaver.

• Kan på sikt brukes av EPJer eller andre systemer for å velge blant et utvalg av verktøy som de skal kunne sende ut (som en erstatning for Verktøyformidleren)

• Har ikke støtte for retur av pseudo-ID

Dokumentasjon og mer informasjon: se denne siden

Dokumentasjon og mer info: Verktøystartoppgave

{BaseUrl}/verktoy/v1/Verktoy

VerktoyId

guid

Verktøyets unike ID slik det er lagret i Verktøykatalogen

InnbyggerFnr

string

Innbyggers fødselsnummer (type string). Merk! det vil bli feilrespons dersom innbygger ikke er digital aktiv på Helsenorge.

BehandlerHpr

string

Dette skal være behandlers HPR-nummer dersom dette er kjent i systemet som benytter API-et.

BehandlerFnr

string

Kan benyttes dersom behandlers HPR-nummer ikke er kjent i systemet som benytter API-et

FristDato

DateTime?

Valgfritt. Frist benyttes for å angi når oppgaven skal utføres. Hvis ikke frist angis settes den to uker frem i tid. Innbygger vil også ha mulighet til å utføre oppgaven i tre måneder etter at fristen har utløpt.

MERK! Helsenorge benytter kun angitte datoer i forretningslogikken. (Dvs. eventuell angivelse av time, minutt etc., tas ikke hensyn til)

Melding

string

Valgfritt. En tekstlig beskrivelse av oppgaven som vises til innbygger. Vises i tillegg til en standardtekst om at innbygger har mottatt en oppgave om å ta i bruk et verktøy. Maks. 1500 tegn.

JSON:

HPR-nummer kjent i system som benytter API, dato for frist og egen melding er angitt:

JSON:

Kun behandlers fødselsnummer er kjent i systemet som benytter API-et:

PseudoId er pasientens generete PseudoId på helsenorge for den API-klient som utfører kallet.

{BaseUrl}/verktoy/v1/SelvstendigVerktoy?Fagomrader=2&Malgrupper=2&Sprak=1&KanLeggesTilAvInnbygger=false&KunAnonymTilgang=true&Siderefereanse=1&AntallVerktoy=20

Fagomrader

list<enum>

Fagområde som verktøyet tilhører:

1. Psykisk helse

2. Fysisk helse

3. Livsstil

Klassifiseringer

list<string>

SNOMED CT-klassifisering for verktøyet.

Malgrupper

list<enum>

Verktøyets målgrupper:

1. Barn

2. Ungdom

3. Voksne

4. Eldre

Sprak

list<enum>

Hvilke språk som verktøyet støtter

1. Bokmål

2. Nynorsk

3. Engelsk

KanLeggesTilAvInnbygger

bool?

Om verktøyet er tilgjengelig for alle, eller om det kun er tilgjengelig hvis innbygger får det tilsendt fra en behandler.

KunAnonymTilgang

bool?

Om verktøyet er helt åpent (ikke krever innlogging) og er tilgjengelig for alle,
eller om det krever sentral brukerprofil og kun er tilgjengelig hvis innbygger får det tilsendt fra en behandler.

Sidereferanse

int

I forbindelse med paginering, hvilken side som skal returneres.

AntallVerktoy

int

Antall verktøy som returneres, maks antall er 50.

VerktoyId

guid

Verktøyets unike id

Navn

string

Verktøyets navn

Ingress

string

Innledende beskrivelse av verktøyet

Beskrivelse

string

Beskrivelse av verktøyet

OpprettetDato

DateTime

Når verktøyet ble opprettet

EndretDato

DateTime

Når verktøyet sist ble endret

VerktoyFormalTypeId

int

Enumverdi for verktøyets formål:

Verdier: 2, 4, 5

VerktoyFormalNavn

string

Navn på verktøyets formål

Verdier:

• Læring (VerktoyFormalTypeId: 2)

• Behandling (VerktoyFormalTypeId: 4)

• Kartlegging (VerktoyFormalTypeId: 5)

FagligAnsvarlig

string

Hvem som har det faglige ansvaret for verktøyet

UtvikletAv

string

Hvem som har utviklet verkøyet

SprakKode

string

Hvilke språk verktøyet støtter.

Verdier:

• "en-GB" (engelsk)

• "nn-NO" (nynorsk)

• "nb-NO" (bokmål)

SprakNavn

string

Språknavn:

Verdier:

• Engelsk

• Norsk Nynorsk

• Norsk Bokmål

FagomradeType

int

Fagområde verktøyet tilhører

Verdier: 1, 2, 3

FagomradeNavn

string

Navn på fagområde:

• Psykisk helse (FagomradeType: 1)

• Fysisk Helse (FagomradeType: 2)

• Livsstil (FagomradeType: 3)

LenkeType

enum

Type lenke tilknyttet verktøyet. Returnerer verdi 50 som er den eneste gyldige verdien i denne responsen.

LenkeTypeNavn

string

Lenketypens navn, returnerer: “Lenke til verktøy“

Url

Uri

Lenke til verkøyet

Sokeord

List<string>

Predefinerte søkeord som beskriver verktøyet

MalgruppeTypeId

int

Id for verkøyets målgrupper

Verdier: 1, 2, 3, 4

MalgruppeNavn

string

Målgruppenavn

Verdier:

• Barn (MalgruppeTypeId: 1)

• Ungdom (MalgruppeTypeId: 2)

• Voksne (MalgruppeTypeId: 3)

• Eldre (MalgruppeTypeId: 4)

GrafiskElementId

int

Id til verkøyets grafiske element

GrafiskElementTypeNavn

string

Type grafisk element

Verdier:

• Bilde

• Ikon

InnholdstypeId

int

Id for verktøyets innholdstype

Verdier: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

InnholdstypeNavn

string

Navn på innholdstype

Verdier:

• Video (InnholdstypeId: 1)

• Podcast (InnholdstypeId: 2)

• Informasjon (InnholdstypeId: 3)

• Oppgaver (InnholdstypeId: 4)

• Spill (InnholdstypeId: 5)

• Chat (InnholdstypeId: 6)

• Forum (InnholdstypeId: 7)

• Egenregistreringer (InnholdstypeId: 8)

• Måleverktøy (InnholdstypeId: 9)

• Anbefalinger og råd (InnholdstypeId: 10)

Behandlerinnsyn

string

Beskriver verktøyets behandlerinnsyn

Verdier:

• “Ingen”

• “Krever”

• “Tilbys i verktøyet”

KlassifiseringKode

string

Klassifiseringskode

KlassifiseringNavn

string

Klassifiseringnavn

KreverForskrivning

bool

Om verktøyet kun er synlig og tilgjengelig hvis behandler har sendt det til aktuell innbygger

Organisasjonsnummer

int

Organisasjonsnummer til verktøyets dataansvarlig

Organisasjonsnavn

string

Organisasjonsnavn til verktøyets dataansvarlig

AntattTid

int?

Antatt tid det tar å gjennomføre verktøyet (angitt i minutter).

{BaseUrl}/verktoy/v1/SelvstendigVerktoy/08ead360-0d65-448c-ba9e-8a08f0921c90

guid

Unik id for verktøy

VerktoyId

guid

Verktøyets unike id

Navn

string

Verktøyets navn

Ingress

string

Innledende beskrivelse av verktøyet

Beskrivelse

string

Beskrivelse av verktøyet

OpprettetDato

DateTime

Når verktøyet ble opprettet

EndretDato

DateTime

Når verktøyet sist ble endret

VerktoyFormalTypeId

int

Enumverdi for verktøyets formål:

Verdier: 2, 4, 5

VerktoyFormalNavn

string

Navn på verktøyets formål

Verdier:

• Læring (VerktoyFormalTypeId: 2)

• Behandling (VerktoyFormalTypeId: 4)

• Kartlegging (VerktoyFormalTypeId: 5)

FagligAnsvarlig

string

Hvem som har det faglige ansvaret for verktøyet

UtvikletAv

string

Hvem som har utviklet verkøyet

SprakKode

string

Hvilke språk verktøyet støtter.

Verdier:

• "en-GB" (engelsk)

• "nn-NO" (nynorsk)

• "nb-NO" (bokmål)

SprakNavn

string

Språknavn:

Verdier:

• Engelsk

• Norsk Nynorsk

• Norsk Bokmål

FagomradeType

int

Fagområde verktøyet tilhører

Verdier: 1, 2, 3

FagomradeNavn

string

Navn på fagområde:

• Psykisk helse (FagomradeType: 1)

• Fysisk Helse (FagomradeType: 2)

• Livsstil (FagomradeType: 3)

LenkeType

enum

Type lenke tilknyttet verktøyet. Returnerer verdi 50 som er den eneste gyldige verdien i denne responsen.

LenkeTypeNavn

string

Lenketypens navn, returnerer: “Lenke til verktøy“

Url

Uri

Lenke til verkøyet

Sokeord

List<string>

Predefinerte søkeord som beskriver verktøyet

MalgruppeTypeId

int

Id for verkøyets målgrupper

Verdier: 1, 2, 3, 4

MalgruppeNavn

string

Målgruppenavn

Verdier:

• Barn (MalgruppeTypeId: 1)

• Ungdom (MalgruppeTypeId: 2)

• Voksne (MalgruppeTypeId: 3)

• Eldre (MalgruppeTypeId: 4)

GrafiskElementId

int

Id til verkøyets grafiske element