10.3.5 | Twiin-05 | Retrieve Resource

This page describes the transaction of the retrieval of the FHIR® resources referenced in the input field of the Notification or Workflow Task.
These input fields contain valueReference combined with the input type “read-resource” or a LOINC or SNOMED CT code.

Scope

This transaction supports the request of resources by the Requesting System to the Resource Server.

Use Case Roles

Actor: Receiving GtK

Role: Sends a request for a specific resource on behalf of a retrieving user.

Actor: Sending GtK (Resource Server)

Role: Processes the request and responds with the requested resource.

Referenced Standards

HL7® FHIR® standard STU3 https://hl7.org/fhir/stu3

Messages

Request message

The requesting system wants to obtain the resources that were referenced in the Task. These resources are retrieved using a FHIR® read interaction, i.e. executing an HTTP GET request to the resource servers FHIR® endpoint. If there is a relative path, the input valueReference must be appended to the FHIR® base-url.

CODE

GET [base]/<ResourceType>/<id>

The requesting system may provide the HTTP Accept header. Valid values for this header are application/fhir+json or application/fhir+xml. If none is set, the resource server will use its default.

Response message

The resource server returns the resource that is requested.

The payload of this message is the requested FHIR® resource. This message is returned to the Receiving System.

The media type of the HTTP body must be either application/fhir+json or application/fhir+xml, based on the Accept header or default response content type.

When an error occurs an OperationOutcome resource must be returned with more details on the reason.

The HTTP response must be accompanied with the correct HTTP status code, e.g.:

200 OK - The search was processed and a valid response was returned
401 Not Authorized - Authorization is required for the interaction that was attempted
404 Not Found - The resource could not be found
410 Gone - The resource was deleted

The requesting system processes the response according to application defined rules.