Доступ к API DICOMweb для управления данными DICOM

Служба DICOM позволяет хранить, просматривать, искать и удалять объекты DICOM® с помощью подмножества API DICOMweb. API DICOMweb — это веб-службы, которые соответствуют стандарту DICOM. Используя эти API, вы можете получить доступ к данным DICOM вашей организации и управлять ими, не требуя сложных протоколов или форматов.

Поддерживаемые службы:

• Store (STOW-RS): отправка объектов DICOM на сервер.
• Получение (WADO-RS): скачивание объектов DICOM с сервера.
• Поиск (QIDO-RS): поиск объектов DICOM на сервере на основе условий.
• Удаление: удаление объектов DICOM с сервера.
• Служба рабочих списков (UPS Push и Pull SOPs): управление и отслеживание рабочих процессов медицинской визуализации.

Помимо подмножества API DICOMweb служба DICOM поддерживает эти пользовательские API, уникальные для Майкрософт:

• Канал изменений: отслеживайте изменения данных DICOM с течением времени.
• Теги расширенных запросов: определение настраиваемых тегов для запроса данных DICOM.
• Массовое обновление
• Массовый импорт
• Экспорт

Необходимые компоненты

• Разверните экземпляр службы DICOM. Дополнительные сведения см. в статье "Развертывание службы DICOM с помощью портал Azure".

• Найдите URL-адрес службы. Используйте портал Azure, чтобы перейти к экземпляру службы DICOM, чтобы найти URL-адрес службы. URL-адрес службы для доступа к службе DICOM использует следующий формат: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com Обязательно укажите версию в качестве части URL-адреса при выполнении запросов. Дополнительные сведения см. в разделе "Управление версиями API" для службы DICOM.

Использование методов REST API для взаимодействия со службой DICOM

Служба DICOM предоставляет веб-интерфейс, который следует принципам REST (передачи репрезентативного состояния). REST API позволяет различным приложениям или системам взаимодействовать друг с другом с помощью стандартных методов, таких как GET, POST, PUT и DELETE. Для взаимодействия со службой DICOM используйте любой язык программирования, поддерживающий HTTP-запросы и ответы.

Ознакомьтесь с примерами для конкретного языка. Примеры коллекции Postman можно просмотреть на нескольких языках, включая следующие.

• Go
• Java
• JavaScript
• C#
• PHP
• C
• NodeJS
• Objective-C
• OCaml
• PowerShell
• Python
• Ruby
• Swift

C#

Сведения об использовании API DICOMweb Standard с C# , чтобы узнать, как использовать C# со службой DICOM.

cURL

cURL — это обычное средство командной строки для вызова веб-конечных точек и доступно для большинства операционных систем. Чтобы приступить к работе, скачайте cURL.

Чтобы узнать, как использовать cURL со службой DICOM, ознакомьтесь с помощью API DICOMWeb™ Standard с cURL.

Python

Дополнительные сведения об использовании Python со службой DICOM см. в статье Об использовании API DICOMWeb™ Standard с Python.

Почтальон

Postman — это отличное средство для проектирования, создания и тестирования REST API. Скачайте Postman , чтобы приступить к работе. Дополнительные сведения см. на сайте обучения Postman.

Одной из важных предостережений с Postman и стандартом DICOMweb является то, что Postman поддерживает отправку файлов DICOM только с помощью полезных данных с одной частью, определенной в стандарте DICOM. Это связано с тем, что Postman не может поддерживать пользовательские разделители в многопартийном запросе POST. Дополнительные сведения см. в разделе Multipart POST, не работающая для меня # 576. Все примеры в коллекции Postman для отправки документов DICOM с помощью многопартийного запроса префиксируются с [не будет работать — см. описание]. Примеры отправки с помощью однопартийного запроса включаются в коллекцию и префиксируются с помощью хранилища с одним экземпляром.

Чтобы использовать коллекцию Postman, скачайте ее локально, а затем импортируйте коллекцию через Postman. Сведения о доступе к коллекции см. в примерах коллекции Postman.

Следующие шаги

Использование API DICOMweb Standard с C#

Использование API DICOMweb Standard с cURL

Использование API DICOMweb Standard с Python

Использование API DICOMWeb Standard с коллекцией примеров Postman

Оператор соответствия DICOM

Примечание.

DICOM® является зарегистрированным товарным знаком Национальной ассоциации производителей электрических технологий для публикаций по стандартам, касающихся цифровых коммуникаций медицинской информации.