DICOM PS3.18 2019e - Web Services |
---|
This Transaction uses the GET method to retrieve the Target Resource. The media type in the response payload will depend on the Target URI and the Query Parameters; for example, Instances as application/dicom, Metadata as application/dicom+json or rendered Instances as application/jpeg images.
The retrieve transaction supports DICOM, Rendered, and Thumbnail Resources.
The request shall have the following syntax:
GET SP "/" {/resource} {?parameter*} SP versionCRLF
Accept: 1#media-type CRLF
*(header-fieldCRLF)
CRLF
Where parameter is one of the Query Parameters defined for the Target Resource in Section 10.4.1.2.
Table 10.4.1-1 defines the DICOM resources that may be retrieved.
Table 10.4.1-2 defines the resources used to retrieve the metadata contained in Instances.
The Metadata Resources are used to retrieve the DICOM instances without retrieving Bulkdata. The Metadata returned for a study, series, or instance resource includes all Attributes in the resource. For Data Elements having a Value Representation (VR) of DS, FL, FD, IS, LT, OB, OD, OF, OL, OW, SL, SS, ST, UC, UL, UN, US, and UT, the origin server is permitted to replace the Value Field of the Data Element with a Bulkdata URI. The user agent can use the Bulkdata URI to retrieve the Bulkdata.
A Retrieve Transaction on a Rendered Resource will return a response that contains representations of a DICOM Resource rendered as appropriate images, videos, text documents, or other representations. Its primary use case is to provide user agents with a simple means to display medical images and related documents, without requiring deep knowledge of DICOM data structures and encodings.
A Rendered Resource contains one or more rendered representations, i.e., in a Rendered Media type, of its parent DICOM Resource. Table 10.4.1-3 shows the Rendered Resources supported by the Retrieve transaction along with their associated URI templates.
The origin server shall be able to render all valid Instances of the Composite SOP classes for which conformance is claimed, e.g., origin server shall be able to render all Photometric Interpretations that are defined in the IOD for that SOP class.
The content type of the response payload shall be a Rendered Media Type. See Section 8.7.4.
A Retrieve Transaction on a Thumbnail resource will return a response that contains a rendered representation of its parent DICOM Resource.
Table 10.4.1-4 shows the Thumbnail resources supported by the Retrieve transaction along with their associated URI templates.
Table 10.4.1-4. Retrieve Transaction Thumbnail Resources
/studies/{study}/thumbnail |
|
/studies/{study}/series/{series}/thumbnail |
|
/studies/{study}/series/{series}/instances/{instance}/thumbnail |
|
/studies/{study}/series/{series}/instances/{instance}/frames/{frames}/thumbnail |
The representation returned in the response to a Retrieve Thumbnail resource request shall be in a Rendered Media Type. The Thumbnail shall not contain any Patient Identifying Information. Only a single image shall be returned.
If the origin server supports any of the Thumbnail resources, it shall support all of them.
The origin server will determine what constitutes a meaningful representation.
The origin server may return a redirection response (HTTP status code 302) to a rendered resource instead of returning a rendered image.
There is no requirement that Thumbnail resources be related to any Icon Image Sequence (0088,0200) encoded in Instances or returned in query responses.
The origin server shall support Query Parameters as required in Table 10.4.1-5.
The user agent shall supply in the request Query Parameters as required in Table 10.4.1-5.
The origin server shall support header fields as required in Table 10.4.1-6 in the request.
The user agent shall supply in the request header fields as required in Table 10.4.1-6.
See also Section 8.4.
DICOM PS3.18 2019e - Web Services |
---|