\n \n \n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n    \n        \n            \n            \n            \n        \n    \n    \n    \n    \n        \n        \n    \n    \n        \n        \n    \n    \n    \n    \n    \n    \n        \n        \n            \n            \n        \n    \n    \n        \n            \n            \n                \n                \n                \n            \n        \n        \n        \n    \n    \n        \n            \n            \n        \n        \n        \n    \n

","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Eksempel Response","type":"text"}]},{"type":"paragraph","content":[{"text":"Se Responskoder.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Swagger","type":"text"}]},{"type":"paragraph","content":[{"text":"Sett inn link til Swagger-dokumentasjon.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Autentisering","type":"text"}]},{"type":"paragraph","content":[{"text":"Token: Uthenting av token gjøres fra STS, for informasjon se: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1886191617"}},{"text":" . For bruk av aksesstoken i etterfølgende kall se: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/23789578/2.+Ekstern+innbyggerl+sning+kaller+Helsenorge+API+i+innbyggerkontekst"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Offentlig sertifikat kan anvendes for avsender til å validere tokenet fra Helsenorge sin STS-tjeneste.","type":"text"},{"type":"hardBreak"},{"text":"Eksempel for mas-02: ","type":"text"},{"text":"https://eksternapi-hn-mas-02.int-hn.nhn.no/sts/oidcprov/v3/jwk","type":"text","marks":[{"type":"link","attrs":{"href":"https://eksternapi-hn-mas-02.int-hn.nhn.no/sts/oidcprov/v3/jwk"}}]}]},{"type":"paragraph","content":[{"text":"Endepunktet har krav om at aktøren som utfører spørringen har sikkerhetsbillett/token utstedt fra Helsenorge sin STS-tjeneste.  I tillegg må timens verdi for identifikator ","type":"text"},{"text":"no-citizenportal-client ","type":"text","marks":[{"type":"em"}]},{"text":"stemme overens med ","type":"text"},{"text":"client_name","type":"text","marks":[{"type":"em"}]},{"text":" i sikkerhetsbilletten (","type":"text"},{"text":"client_name-","type":"text","marks":[{"type":"em"}]},{"text":"verdien settes når tilgangen opprettes i STS), se kapittel \"Respons fra ","type":"text"},{"text":"helsenorge.no","type":"text","marks":[{"type":"link","attrs":{"href":"http://helsenorge.no/"}}]},{"text":"\" - \"Sjekk av kildesystem\" under.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"f5501bfe-9e24-489a-8a3b-57c54f63f19e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"Legg inn eksempel på kode for hvordan man gjør autentiseringen","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Autorisering","type":"text"}]},{"type":"paragraph","content":[{"text":"For å kunne kalle endepunktet så behøves et token utstedt fra vår STS, med scope \"avtaler\".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Token mangler eller ikke er gyldig","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lagres ikke på Helsenorge","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTP 401 (unauthorized) og OperationOutcome ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.severity = fatal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.Code = forbidden","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.details.text = beskrivelse av feilen","type":"text"}]}]}]}]}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"84115451-7d2f-4d6d-a0e9-f5079a80408a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\n    \n        \n        \n        \n            \n        
\n    \n","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Terms and Conditions","type":"text"}]},{"type":"paragraph","content":[{"text":"Vilkår og betingelser for bruk av API'et kan finnes her: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1346634744"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Begrensninger","type":"text"}]},{"type":"paragraph","content":[{"text":"Ved behov for større datamigreringer skal Helsenorge varsles i forkant og tidspunkt avtales via kundesenter@nhn.no","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Start på å jobbe mot endepunktet","type":"text"}]},{"type":"paragraph","content":[{"text":"Eksempel på hvordan raskt komme i gang med bruk av API'et, feks med Postman eller lignende. Inkluder også eksempel på en enkel request og response:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kontakt NHN og få autentisering","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Last ned Postman","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Send request som vist under","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"452b9896-9d81-43da-9787-05a7a24534f5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"Request","type":"text"}]}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Motta respons som vist under","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"c0a7f9df-17da-4bdb-89f6-641455e0655b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"Response","type":"text"}]}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Du er tilkoblet endepunktet.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Responskoder","type":"text"}]},{"type":"paragraph","content":[{"text":"Beskriv her hvilke feilmeldinger brukeren kan få og hva de betyr","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"5f759e9e-b496-4ca2-a89a-8c7f63ee881c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[430.0]},"content":[{"type":"paragraph","content":[{"text":"Kode","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Beskrivelse","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[430.0]},"content":[{"type":"paragraph","content":[{"text":"200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"OK. Oppdatert","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[430.0]},"content":[{"type":"paragraph","content":[{"text":"201","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"OK. Opprettet","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[430.0]},"content":[{"type":"paragraph","content":[{"text":"4xx","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Feilkode i henhold til FHIR spesifikasjon ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Valideringer","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sjekk av innhold","type":"text"}]},{"type":"expand","attrs":{"title":"Sjekk av innhold"},"content":[{"type":"paragraph","content":[{"text":"Ved mottak av timenotifikasjoner verifiseres det at at Appointment-objektet inneholder den påkrevde FHIR-informasjonen, timeobjektet må ha status booked, cancelled eller entered-in-error.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Innhold validerer ikke","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lagres ikke på Helsenorge","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTP 400 (","type":"text"},{"text":"bad request","type":"text","marks":[{"type":"em"}]},{"text":") og OperationOutcome ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.severity = fatal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.Code = structure/required/invariant (se ","type":"text"},{"text":"issue type","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/valueset-issue-type.html"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.details.text = beskrivelse av feilen","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Structure - A structural issue in the content such as wrong namespace, unable to parse the content completely, invalid syntax, etc.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"Unable to parse content"},"content":[{"type":"table","attrs":{"layout":"default","localId":"06853a29-1f5d-41b7-b13c-392d50418000"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1439.0]},"content":[{"type":"codeBlock","content":[{"text":"\n    \n        \n        \n        \n            \n        
\n    \n","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Required elements are missing"},"content":[{"type":"table","attrs":{"layout":"default","localId":"b9dcb23f-acc5-43c2-8a56-3ecb33232107"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1439.0]},"content":[{"type":"codeBlock","content":[{"text":"\n    \n        \n        \n        \n            \n        
\n    \n","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"A content validation rule failed"},"content":[{"type":"table","attrs":{"layout":"default","localId":"3e52e7a1-8036-45a5-9175-20aff81d646a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1439.0]},"content":[{"type":"codeBlock","content":[{"text":"\n    \n        \n        \n        \n            \n        
\n    \n","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sjekk av kildesystem","type":"text"}]},{"type":"expand","attrs":{"title":"Sjekk av kildesystem"},"content":[{"type":"paragraph","content":[{"text":"Avsendersystem får kun lagre timenotifikasjoner som tilhører sitt kildesystem. Kildesystem er definert av Appointment.identifier-verdien no-citizenportal-client, som må matche med klientnavnet (client_name) som aktøren er registrert med i Helsenorge STS.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kildesystem matcher ikke registrert systemnavn","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lagres ikke på Helsenorge","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTP 403 (","type":"text"},{"text":"forbidden","type":"text","marks":[{"type":"em"}]},{"text":") og OperationOutcome ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.severity = fatal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.Code = forbidden","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issue.details.text = beskrivelse av feilen","type":"text"}]}]}]}]}]}]}]}]},{"type":"expand","attrs":{"title":"Not allowed to generate appointments"},"content":[{"type":"table","attrs":{"layout":"default","localId":"866eef59-d0ad-49c2-a493-1df1312913a2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1439.0]},"content":[{"type":"codeBlock","content":[{"text":"\n    \n        \n        \n        \n            \n        
\n    \n","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Versjonering og endringer","type":"text"}]}],"version":1}

Browser not supported