N.5.3 DICOM Web Services

N.5.3 DICOM Web Services (Current)
Prev	N.5 Service and Interoperability Description	Next

N.5.3.1 URI Web Service (WADO URI)

This section provides details regarding the URI Web Service. For an overview of the supported transactions see Table N.1-8 URI Service.

N.5.3.1.1 Supported Web Media Types

N.5.3.1.1.1 DICOM Media Types

The supported DICOM Storage SOP Classes / Transfer Syntaxes are listed in Section N.1.1 of this document.

[Provide requirements for display and processing of instances received via Web Services. This could either be done by referencing Section N.5.2.5.2 if the same requirements apply, or by copying the tables from Section N.5.2.5.2 and filling them appropriately, if the requirements for Web Services differ.]

N.5.3.1.1.2 Rendered Media Types

Table N.5-61 lists the supported rendered Media types depending on the Media Type category.

[Indicate which category / Media types are supported by your system by marking the cells with Y or N. Remove rows for Media Types neither supported as user agent nor as Origin Server].

Table N.5-61. Supported Rendered Media Types

Category	Media Type	URI User Agent	URI Origin Server
Single Frame Image	image/jpeg
	image/gif
	image/png
	image/jp2
Multi-Frame Image	image/gif
Video	video/mpeg
	video/mp4
	video/H265
Text	text/html
	text/plain
	text/xml
	text/rtf
	application/pdf

N.5.3.1.2 Retrieve DICOM Instance Transaction - URI Web Service

[Provide requirements for display and processing of instances retrieved via URI Web Service. This could either be done by referencing Section N.5.2.5.2 (as indicated below), if the same requirements apply, or by copying the tables from Section N.5.2.5.2 and filling them appropriately if requirements for retrieved instances differ.]

In order to display or process DICOM instances retrieved via URI Web Service, see Section N.5.2.5.2.

N.5.3.1.2.1 User Agent

The URI Web Service user agent supports the Query Parameters listed in Table N.5-62.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-62. Query Parameters for Retrieve DICOM Instance URI Web Service - User Agent

Query Parameter	Supported Values	Comments
requestType	WADO
studyUID	<Study Instance UID>
seriesUID	<Series Instance UID>
objectUID	<SOP Instance UID>
contentType	application/dicom	[Must be compatible with the acceptable Media Types in the HTTP Header] See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "UA" column
charset	<<UTF-8 ISO-8859-1 …>>
anonymize	yes
transferSyntax

The URI Web Service User Agent supports the Header Fields listed in Table N.5-63:

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-63. Header Fields for Retrieve DICOM Instance URI Web Service - User Agent

Header Field	Supported Values	Comments
Accept	application/dicom	See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "UA" column
Accept-charset	<<UTF-8 ISO-8859-1 …>>

Header Field

Supported Values

Comments

application/dicom

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "UA" column

Accept-charset

<<UTF-8

ISO-8859-1

…>>

N.5.3.1.2.2 Origin Server

The URI Web Service origin server receives GET requests for studies, series and instances containing query parameters and headers fields. Supported Values are listed in the query parameters and header fields tables (Table N.5-64 and Table N.5-65).

The URI is composed by a Base URI: see Section N.6.3.1 for the Base URI of the Origin Server.

The URI Web Service origin server supports the Query Parameters listed in Table N.5-64.

[List the supported parameters and their Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-64. Query Parameters for Retrieve DICOM Instance URI Web Service - Origin Server

Query Parameter	Supported Values	Comments
requestType	WADO
studyUID	<Study Instance UID>
seriesUID	<Series Instance UID>
objectUID	<SOP Instance ID>
contentType	application/dicom	See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "OS" column
charset	<<UTF-8 ISO-8859-1 …>>
anonymize
transferSyntax

The URI Web Service origin server supports the Header Fields listed in Table N.5-65.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-65. Header Fields for Retrieve DICOM Instance URI Web Service - Origin Server

Header Field	Supported Values	Comments
Accept	application/dicom	See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "OS" column
Accept-charset	<<UTF-8 ISO-8859-1 …>>

Header Field

Supported Values

Comments

application/dicom

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "OS" column

Accept-charset

<<UTF-8

ISO-8859-1

…>>

N.5.3.1.3 Retrieve Rendered Instance Transaction - URI Web Service

[Provide requirements for display and processing of instances retrieved via URI Web Service. This could either be done by referencing section 5.2.5.2 (as indicated below), if the same requirements apply, or by copying the tables from Section 5.2.5.2 and filling them appropriately if requirements for retrieved instances differ.]

To display or process DICOM instances retrieved via URI Web Service, see Section N.5.2.5.2.

N.5.3.1.3.1 User Agent

The URI Web Service user agent supports the Query Parameters listed in Table N.5-66.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-66. Query Parameters for Retrieve Rendered Instance URI Web Service - User Agent

Query Parameter	Supported Values	Comments
requestType	WADO
studyUID	<Study Instance UID>
seriesUID	<Series Instance UID>
objectUID	<SOP Instance UID>
contentType	<<image/jpeg image/gif image/png image/jp2 video/mpeg video/mp4 video/H265 text/html text/plain>>	See Section N.5.3.1.1.2 for details
charset	<<UTF-8 ISO-8859-1 …>>
annotation
rows
columns
region
windowCenter
windowWidth
frameNumber
imageQuality		[The Value must be between 1 and 100. 1 means low quality and 100 imeans high quality]
presentationUID and presentationSeriesUID		[if presentationUID specified then presentationSeriesUID must be present.]

The URI Web Service user agent supports Header Fields listed in Table N.5-67.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-67. Header Fields for Retrieve Rendered Instance URI Web Service - User Agent

Header Field	Supported Values	Comments
Accept	<<image/jpeg image/gif image/png image/jp2 video/mpeg video/mp4 video/H265 text/html text/plain>>	See Section N.5.3.1.1.2 for details
Accept-charset	<<UTF-8 ISO-8859-1 …>>

Header Field

Supported Values

Comments

<<image/jpeg

image/gif

image/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain>>

See Section N.5.3.1.1.2 for details

Accept-charset

<<UTF-8

ISO-8859-1

…>>

N.5.3.1.3.2 Origin Server

The URI is composed by a Base URI: see Section N.6.3.1 for the Base URI of the origin server.

The URI Web Service origin server supports Query Parameters listed in Table N.5-68.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-68. Query Parameters for Retrieve Rendered Instance URI Web Service - Origin Server

Query Parameter	Supported Values	Comments
requestType	WADO
studyUID	<Study Instance UID>
seriesUID	<Series Instance UID>
objectUID	<SOP Instance ID>
contentType	<<image/jpeg image/gif imag/png image/jp2 video/mpeg video/mp4 video/H265 text/html text/plain >>	See details in Section N.5.3.1.1.2
charset	<<UTF-8 ISO-8859-1 …>>
annotation	<<patient technique>> Add additionally supported key word Values here
rows
columns
region
windowCenter
windowWidth
frameNumber
imageQuality		[The Value must be between 1 and 100. 1 means low quality and 100 imeans high quality.]
presentationUID and presentationSeriesUID		[if presentationUID specified then presentationSeriesUID must be present.]

The URI Web Service origin server supports Header Fields listed in Table N.5-69.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-69. Header Fields for Retrieve Rendered Instance URI Web Service - Origin Server

Header Field	Supported Values	Comments
Accept	<<Image/jpeg image/gif image/png image/jp2 video/mpeg video/mp4 video/H265 text/html text/plain>>	See details in Section N.5.3.1.1.2 Rendered Media Types

Header Field

Supported Values

Comments

<<Image/jpeg

image/gif

image/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain>>

See details in Section N.5.3.1.1.2 Rendered Media Types

Prev	Up	Next
N.5.2.8.9 SCP of the Basic Annotation Box SOP Class	Home	N.5.3.2 Studies Web Service