0.1.0 - ci-build
MADO, published by Example Publisher. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/oijauregui/MADO-through-FHIR-Publisher/ and changes regularly. See the Directory of published versions
This transaction is used by the Imaging Document Consumer to retrieve DICOM instances from the Imaging Document Source using WADO-RS (Web Access to DICOM Objects - RESTful Services).
| Actor | Role |
|---|---|
| Imaging Document Consumer | Requests DICOM instances using WADO-RS |
| Imaging Document Source | Provides DICOM instances in response to WADO-RS requests |
This transaction involves the following message exchanges:
The Imaging Document Consumer triggers this message when:
The Get Instances Request follows the DICOM WADO-RS specification for instance retrieval.
HTTP Method: GET
Request URL Format:
{service}/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}
Query Parameters:
accept: Specifies the acceptable media types for the responsetransferSyntax: Optionally specifies the desired transfer syntaxHTTP Headers:
Accept: Specifies acceptable content types (e.g., application/dicom)Authorization: Contains authentication credentials if requiredGET /wado-rs/studies/1.2.840.113619.2.55.3.604688119.971.1234567890.123/series/1.2.840.113619.2.55.3.604688119.971.1234567890.456/instances/1.2.840.113619.2.55.3.604688119.971.1234567890.789 HTTP/1.1
Host: example-pacs.hospital.org
Accept: application/dicom
Authorization: Bearer <token>
User-Agent: MADO-Client/1.0
The Imaging Document Consumer shall:
The Imaging Document Source generates this response upon receiving a valid Get Instances Request.
HTTP Status Codes:
200 OK: Instance successfully retrieved206 Partial Content: Partial instance content (if range requests are used)400 Bad Request: Invalid request parameters401 Unauthorized: Authentication required or failed403 Forbidden: Access denied404 Not Found: Requested instance not found500 Internal Server Error: Server error occurredResponse Headers:
Content-Type: application/dicom or multipart/relatedContent-Length: Size of the response bodyETag: Entity tag for caching supportResponse Body:
The Imaging Document Source shall:
The Imaging Document Consumer triggers this message when:
HTTP Method: GET
Request URL Format:
{service}/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}/rendered
Query Parameters:
accept: Specifies acceptable media types (e.g., image/jpeg, image/png)viewport: Specifies the viewport dimensionswindow: Specifies window/level parametersquality: Specifies compression quality for JPEGHTTP Headers:
Accept: Specifies acceptable image formatsAuthorization: Contains authentication credentials if requiredGET /wado-rs/studies/1.2.840.113619.2.55.3.604688119.971.1234567890.123/series/1.2.840.113619.2.55.3.604688119.971.1234567890.456/instances/1.2.840.113619.2.55.3.604688119.971.1234567890.789/rendered?viewport=512,512&window=350,40 HTTP/1.1
Host: example-pacs.hospital.org
Accept: image/jpeg
Authorization: Bearer <token>
User-Agent: MADO-Client/1.0
The Imaging Document Consumer shall:
The Imaging Document Source generates this response upon receiving a valid Get Rendered Instances Request.
HTTP Status Codes: Similar to Get Instances Response
Response Headers:
Content-Type: Image media type (e.g., image/jpeg, image/png)Content-Length: Size of the image dataResponse Body:
The Imaging Document Source shall:
application/dicom and standard image formatsAll WADO-RS transactions shall be audited according to ATNA requirements:
The Imaging Document Consumer shall:
The Imaging Document Source shall: