API- Opprette ny Part
API-navn | Personverninnstilling- Opprette ny Part |
|---|---|
Funksjonelt område | |
API-versjon og dato publisert | V1 |
Status | Under utvikling |
API-dokumentasjon sist endret | Oct 3, 2025 |
Teknologi | REST |
Denne er under utarbeidelse, representerer første utkast for kvalitetssikring. Endringer kan forekomme i endelig versjon.
API'ets formål
API`et gir eksterne aktører mulighet til å opprette en ny Part koblet til sin Aktør. Den nye parten kan igjen brukes ved opprettelse av nye personverninnstilling definisjoner basert på en eksisterende mal API- Opprette personverninnstillingsdefinisjon. Den nye parten identifiserers av en unik part kode og kobles til aktøren som er registrert for API klienten som oppretter parten.
Tjenesteoversikt
Navn | Http verb | Beskrivelse |
|---|---|---|
Opprett part | POST <system url>/personvern/part/v1 | Oppretter en ny part |
Oppdater part | PATCH <system url>/personvern/part/v1 | Oppdaterer en eksisterende part |
Autorisasjon og aksesstoken
HelseId sin autoriseringstjeneste for maskin-til-maskin skal benyttes:
Velg Helsenorge Ekstern API i HelseId sin selvbetjeningsløsning
Velg deretter scope “personverndefinisjoner_skriv”
Når tilgangen er godkjent av Helsenorge, kan aksesstoken hentes ut fra HelseId
Se ytterligere detaljer her: 3. Ekstern applikasjon kaller Helsenorge API i systemkontekst
3. Ekstern applikasjon kaller Helsenorge API i systemkontekst
AksessToken som mottas fra HelseId eller Helsenorge STS skal deretter være med i Authorization header i alle HTTP-requestene.
Opprett part
Request parametere
Navn | Type | Påkrevd / Frivillig | Lovlige verdier | Kommentar |
|---|---|---|---|---|
partMalGuid | Guid | Påkrevd | Guid for eksisterende part mal i PVK | Part malens unike ID |
partKode | string | Påkrevd | En ny unik partkode | Part koder defineres med små bokstaver uten æ, ø, å eller andre spesialtegn. Mellomrom ersattes med bindestrek (-). Ved behov for flere partkoder anbefales det at de grupperes sammen med en felles identifikator som prefix før den unike delen av partkoden. For eksempel: kj-innstillinger NB: Eventuelle mellomrom i starten/slutten av partKoden vil strippes vekk og øvrige mellomrom i koden vil erstattes med bindestrek ved lagring. |
navn | string | Påkrevd | Navn på register/ forskningsprosjekt/ studie/ biobank | Det offisielle navnet på parten, dette vil vises til innbygger på Helsenorge. |
beskrivelse | string | Påkrevd | En beskrivelse av register/ forskningsprosjekt/ studie/ biobank |
|
uri | string | Frivillig | URI for å lese med om register/ forskningsprosjekt/ studie/ biobank |
|
Eksempel : Opprette ny part
{
"partKode": "kpr",
"navn": "Kommunalt pasient- og brukerregister",
"beskrivelse": "Dette er en beskrivelse av KPR"
}Response parametere
201 - Created
Oppdater part
Kun aktør som eier en part kan oppdatere denne. Eierskap identifiseres av API klient id for den aktøren som opprettet parten. Det er kun utvalgte felter på en part som kan oppdateres. Request parametere som ikke er med eller har verdien null vil ikke medføre oppdatering av relevante felter på parten.
Request parametere
Navn | Type | Påkrevd / Frivillig | Lovlige verdier | Kommentar |
|---|---|---|---|---|
partKode | string | Påkrevd | En eksisterende partkode | Denne verdien brukes til å identifisere parten som skal oppdateres. Denne verdien kan ikke endres. |
navn | string | Frivillig | Navn på register/ forskningsprosjekt/ studie/ biobank | Det offisielle navnet på parten, dette vil vises til innbygger på Helsenorge. |
beskrivelse | string | Frivillig | En beskrivelse av register/ forskningsprosjekt/ studie/ biobank |
|
uri | string | Frivillig | URI for å lese med om register/ forskningsprosjekt/ studie/ biobank |
|
Eksempel : Oppdatere eksisterende definisjon
{
"partKode": "kpr",
"beskrivelse": "Dette er en ny beskrivelse av KPR"
}Response parametere
204 - No Content