Page Comparison

...

• Method + Url: POST [base]/[type]

• Content-Type: En av verdiene fra generell del over

• Body: En FHIR ressurs av type [type]

  • Dersom ressursen har en ressurs-ID fra før, vil denne ikke hensyntas, men Helsenorge tildeler ressursens ID.

  • Alle ressursene som kan opprettes på Helsenorge har en “resource”.identifier. Det er denne som identifiserer en ressurs entydig mellom Helsenorge og aktørene i sektoren. For de fleste ressursene er denne i implementasjonsguiden definert å skulle være en GUID, slik nat at den er globalt unbik mellom aktørene og Helsenorge.

• Respons:

  • OK: 201 Created. Ved suksessfull opprettelse av ressursen og påfølgende respons er Location headeren satt inneholdende logisk id, i tillegg returneres den opprettede ressursen i sin helhet.

  • Feil: 400 Bad Request + FHIR OperationOutcome

...

• Method + Url: POST [base]

• Content-Type: En av verdiene fra generell del over

• Body:

  • En FHIR ressurs av type Bundle av typen “transaction”(Dersom Bundle har en ressurs-ID fra før, vil denne endres)

  • Hver ressurs i Bundle SKAL etterfølges av hvilken operasjon som skal utføres. Det støttes kun HTTP POST operasjon for ressursene i bundelen, dvs. at alle ressursene i Bundelen får en ID tilordnet av Helsenorge når de opprettes.

• Respons:

  • 200 OK + Bundle med Bundle.type = "transaction-response"

  • Feil:

    • 400 Bad Request + Bundle med et sett FHIR OperationOutcome

...

Endre en FHIR ressurs som finnes på Helsenorge

Merk! For mange av FHIR ressurser har vi på Helsenorge valgt å ikke støtte Update ved hjelp av PUT. Dette fordi mange av ressursene inngår i en workflow på Helsenorge, og Helsenorge er derfor avhengig av å selv ha “kontroll” på noen elementer i ressursen. For disse ressursene skal PATCH benyttes dersom ekstern aktør ønsker å modifisere noen elementer i en eksisterende ressurs på Helsenorge.

Patch - HTTP PATCH

Denne kan alltid benyttes for å oppdatere en ressurs som allerede er lagret på Helsenorge.

...

• Method + Url: PATCH [base]/[type]/[id]

• Content-Type: En av verdiene fra generell del over

• Body: FHIRPath Patch

• Respons:

  • 200 OK

  • Feil:

    • 400 Bad request

Update - HTTP PUT

Unntaksvis akseptere Helsenorge aksepterer “Update” ved HTTP PUT for noen ressurser for å endre en allerede eksisterende ressurs. Det støttes ikke opprettelse av ressurser ved hjelp av PUT.Merk! For de fleste FHIR ressurser har vi på Helsenorge valgt å ikke støtte Update ved hjelp av PUT. Dette fordi mange av ressursene inngår i en workflow på Helsenorge, og Helsenorge er derfor avhengig av å selv ha “kontroll” på noen elementer i ressursen. For disse ressursene skal PATCH benyttes dersom ekstern aktør ønsker å modifisere noen elementer i en eksisterende ressurs på HelsenorgeDette er i UseCases der ressursen i sin helhet er en “kopi” på Helsenorge av en ressurs hvor “master” finnes hos helkseforetaket. Det vil framgå i beskrivelsen av det enkelte API/Ressurs., om det støtets “fullstendig overskriving” av ressursen med HTTP PUT.

Det støttes ikke opprettelse av ressurser ved hjelp av PUT.

Request/response:

• Method + Url: PUT [base]/[type]/[id]

• Content-Type: En av verdiene fra generell del over

• Body: En FHIR ressurs av type [type]- Ressursens-ID skal være satt og den samme som er angitt i URL. ID’en skal være den som Helsenorge returnerte når ressursen ble opprettet med POST.

• Respons:

  • 200 OK

  • Feil:

    • 400 Bad Request + FHIR OperationOutcome

...