...

• Content-Type: Påkrevet ved POST, PUT eller PATCH. Skal ha en av verdiene: application/fhir+xml, application/fhir+json, application/json, application/xml eller  application/x-www-form-urlencoded

• Authorization: Påkrevd. Skal ha verdien Bearer <aksesstoken>. (Se 01 - Sikkerhetsmodell og Helsenorge sikkerhetstjeneste )

• Accept: Frivillig. Dersom satt skal ha en av verdiene: application/fhir+xml, application/fhir+json, application/json eller application/xml. (Dersom ikke satt vil responsen sin Content-Type være satt til application/fhir+json) (Se detaljer om hver operasjon, for hvilke verdier som aksepteres).

Støttede operasjoner

Opprette/Lagre en FHIR ressurs på Helsenorge

...

• 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 hensyn tashensyntas, men bestemmes av Helsenorge

  • Mange av ressursene som kan opprettes på Helsenorge har en “resource”.identifier. Dersom denne i profilen for den aktuelle ressurs er spesifisert at skal være en GUID, vil Helsenorge benytte denne som ressursens ID ved “create”.

• 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: 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

For Unntaksvis akseptere Helsenorge “Updaate” for noen ressurser kan klienten benytte “Update” 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 der Helsenorge er derfor avhengig av å selv ha “kontroll” på diverse noen elementer i ressursen. For disse ressursene skal PATCH benyttes dersom ekstern aktør ønsker å modifisere noen elementer i ressursenen eksisterende ressurs på Helsenorge.

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

...