Oppslag ved innlogget bruker (brukerstyrt datadeling)
Introduksjon
Kontaktopplysninger fra Kontakt- og Reservasjonsregisteret er oftest utlevert globalt gjennom Oppslagstjenesten. Men kunder kan også motta kontaktopplysninger kun tilhørende innlogget bruker, og det er i noen sammenhenger mer hensiktsmessig og bruke denne tjenesten.
Bruk av Oauth2
Oppslag ved innlogget bruker baserer seg på brukerstyrt datadeling. I tillegg til idporten-scopene openid og profile, må det forespørres ett eller flere av følgende scopes:
scope | beskrivelse |
---|---|
krr:user/kontaktinformasjon.read | Returnerer epostadresse og mobilnummer + tidspunkt for sist oppdatering |
Returnerer status for om kontaktinfomasjonen kan brukast for varsling iht. eForvaltningsforskrifta sin §32 | |
Returnerer brukerens foretrukne språk for kommunikasjon med det offentlige. | |
krr:user/digitalpost.read | Returnerer adresse for digital post til innbygger |
Returnerer brukerens krypteringssertifikat ved sending av digital post | |
krr:user/spraak.write | Endrer brukerens foretrukne språk for kommunikasjon med det offentlige. |
API-endepunkt
miljø | url |
---|---|
TEST | https://test.kontaktregisteret.no/rest/v1/person |
PROD | https://kontaktregisteret.no/rest/v1/person |
Følgende header-parametere må brukes på request:
Parameter | Verdi |
---|---|
Http-metode: | GET |
Accept: | application/jose (evt. application/json ) |
Authorization: | Bearer <utstedt access_token> |
Eksempel på respons:
Se https://begrep.difi.no/Oppslagstjenesten/Person for definisjon av kodeverket.
{
"personidentifikator": "23079421936",
"reservasjon": "NEI",
"status": "AKTIV",
"varslingsstatus" : "KAN_VARSLES",
"kontaktinformasjon":
{
"epostadresse": "23079421936-test@minid.norge.no",
"epostadresse_oppdatert" : "2018-06-29T10:14:52+02",
}
}
Eksempel på endring av språk:
Forspørselen nedenfor vil endre innlogget bruker sitt foretrukne språk i Kontaktregisteret til engelsk:
PATCH /rest/v1/person
Content-type: application/json
Authorization: Bearer SWDQ_pVct3HIzsIaC3zHDuMmIqffr4ORr508N3p0Mtg=
{
"spraak" : "en"
}
Det er viktig at kunder som bruker skrive-API informerer brukeren om at endringer skjer i et nasjonalt register, og ikke kun for denne tjenesten.
Swagger
OpenAPI-dokumentasjon.
miljø | url |
---|---|
TEST | https://test.kontaktregisteret.no/swagger-ui/index.html |
PROD | https://kontaktregisteret.no/swagger-ui/index.html |