RESTful DICOM Services

Medical Connections has implemented all 3 DICOM Web Services based on the DICOM Standard part 18.

All 3 services share the same underlying DicomServer, and this server is shared with the longstanding DIMSE based server, so it should for instance be possible to send an instance via STOW, and then retrieve via C-GET or the equivalent in reverse with C-STORE & WADO-RS.

Current stage of Development: Alpha

  • Although majority of the functions are supported, some remain to be implemented.
  • Internal testing starting on the 26th of September, 2014. All 3 services are live online for public testing and comments.
  • The main purpose of the current service is to allow others to check whether our interpretation of the standard agrees with theirs, and to identify any discrepancies, which should be reported to support@medicalconnections.co.uk

DICOM STOW-RS (STore Over the Web by RESTful Services)

Web Service Address: "https://dicomserver.co.uk:8989/stow"

  • Supports single/multiple DICOM instances in single/multiple Studies
  • Supports DICOM/Xml & Json media types
  • Compressed Transfer Syntax is "work to be done"
  • Instances Received will be C-STORE'd to the underlying DicomServer
  • Response Status Codes:
    • 415 - UnsupportedMediaType
    • 409 - Conflict
    • 200 - OK
    • 202 - Accepted, with additional information regarding which instances have been stored and which instances have failed to be stored included in the XML response message body.

DICOM QIDO-RS (Query based on ID for DICOM Objects by RESTful Services)

Web Service Address: "https://dicomserver.co.uk:8989/qido"

  • Supports majority of the queries, including:
    • /studies[?query]
    • /studies/{StudyInstanceUID}/series[?query]
    • /series[?query]
    • /studies/{StudyInstanceUID}/series/{SeriesInstanceUID}/instances[?query]
    • /studies/{StudyInstanceUID}/instances[?query]
    • /instances[?query]
  • Supports application/dicom+xml and application/json media types
  • TimezoneOffsetForomUTC and FuzzyMatching are "work to be done", warning header about fuzzy matching is included in response
  • limit and offset are supported. Warning header about number of results exceeding the maximum (100) supported by the server is included in response
  • BulkData reference is "work to be done"
  • QIDO-RS queries are translated into DICOM C-FIND requests which get fired against the same DicomServer used by STOW-RS service
  • Response Status Codes:
    • 200 - OK
    • 400 - Bad Request

DICOM WADO-RS (Web Access to DICOM Objects by RESTful Services)

Web Service Address: "https://dicomserver.co.uk:8989/wado"

  • Supports majority of the requests, including:
    • RetrieveStudy
    • RetrieveSeries
    • RetrieveInstance
    • RetrieveBulkdata
    • RetrieveMetadata
  • RetrieveFrames is "work to be done"
  • Supports multipart application/dicom and application/octet-stream media types.
  • Compressed transfer syntax is "work to be done"
  • Supports Bulkdata reference
  • WADO-RS requests are translated into DICOM C-GET requests which get fired against the same DicomServer used by STOW-RS QIDO-RS services
  • Response Status Codes:
    • 400 - Bad Request
    • 415 - UnsupportedMediaType
    • 200 - OK