DICOMweb API에 액세스하여 DICOM 데이터 관리

아티클
06/05/2024

DICOM® 서비스를 사용하면 DICOMweb API의 하위 집합을 사용하여 DICOM 개체를 저장, 검토, 검색, 삭제할 수 있습니다. DICOMweb API는 DICOM 표준을 따르는 웹 기반 서비스입니다. 이러한 API를 사용하면 복잡한 프로토콜이나 형식 없이 조직의 DICOM 데이터에 액세스하고 관리할 수 있습니다.

지원되는 서비스는 다음과 같습니다.

저장(STOW-RS): DICOM 개체를 서버에 업로드합니다.
찾기(WADO-RS): 서버에서 DICOM 개체를 다운로드합니다.
검색(QIDO-RS): 조건에 따라 서버에서 DICOM 개체를 찾습니다.
삭제: 서버에서 DICOM 개체를 제거합니다.
작업 목록 서비스(UPS 푸시 및 끌어오기 SOP): 의료 이미징 워크플로를 관리하고 추적합니다.

DICOMweb API의 하위 집합 외에도 DICOM 서비스는 Microsoft에 고유한 사용자 지정 API를 지원합니다.

변경 피드: 시간에 따른 DICOM 데이터의 변경 사항을 추적합니다.
확장 쿼리 태그: DICOM 데이터를 쿼리하기 위한 사용자 지정 태그를 정의합니다.
대량 업데이트
대량 가져오기
내보내기

필수 조건

DICOM 서비스의 인스턴스를 배포합니다. 자세한 내용은 Azure Portal을 사용하여 DICOM 서비스 배포를 참조하세요.
서비스 URL을 찾습니다. Azure Portal을 사용하여 DICOM 서비스의 인스턴스로 이동해 서비스 URL을 찾습니다. DICOM 서비스에 액세스하기 위한 서비스 URL은 https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com과 같은 형식을 사용합니다. 요청할 때는 버전을 URL의 일부로 지정해야 합니다. 자세한 내용은 DICOM 서비스에 대한 API 버전 관리를 참조하세요.

REST API 메서드를 사용하여 DICOM 서비스와 상호 작용

DICOM 서비스는 REST(Representational State Transfer) 원칙을 따르는 웹 기반 인터페이스를 제공합니다. REST API를 사용하면 다른 애플리케이션 또는 시스템이 GET, POST, PUT, DELETE와 같은 표준 메서드를 사용하여 서로 통신할 수 있습니다. DICOM 서비스와 상호 작용하려면 HTTP 요청 및 응답을 지원하는 프로그래밍 언어를 사용합니다.

언어 관련 예제를 참조하세요. 다음을 포함한 다양한 언어로 Postman 컬렉션 예를 볼 수 있습니다.

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

C#

DICOM 서비스에서 C#을 사용하는 방법을 알아보려면 C#으로 DICOMweb 표준 API 사용을 참조하세요.

cURL

cURL은 웹 엔드포인트를 호출하기 위한 일반적인 명령줄 도구이며 대부분의 운영 체제에서 사용할 수 있습니다. 시작하려면 cURL을 다운로드합니다.

DICOM 서비스에서 cURL을 사용하는 방법을 알아보려면 cURL로 DICOMWeb™ 표준 API 사용을 참조하세요.

Python

DICOM 서비스에서 Python을 사용하는 방법에 대한 자세한 내용은 Python으로 DICOMWeb™ 표준 API 사용을 참조하세요.

Postman

Postman은 REST API를 디자인, 빌드, 테스트하기 위한 훌륭한 도구입니다. Postman을 다운로드하여 시작합니다. 자세한 내용은 Postman 학습 사이트를 참조하세요.

Postman 및 DICOMweb 표준의 한 가지 중요한 주의 사항은 Postman이 DICOM 표준에 정의된 단일 파트 페이로드를 사용하여 DICOM 파일 업로드만 지원한다는 것입니다. 이는 Postman이 다중 파트/관련 POST 요청에서 사용자 지정 구분 기호를 지원할 수 없기 때문입니다. 자세한 내용은 다중 파트 POST가 작동하지 않음 # 576을 참조하세요. 다중 파트 요청을 사용하여 DICOM 문서를 업로드하기 위한 Postman 컬렉션의 모든 예제에는 [won't work - see description]이라는 접두사가 있습니다. 단일 파트 요청을 사용하여 업로드하는 예제는 컬렉션에 포함되어 있으며 Store-Single-Instance라는 접두사가 있습니다.

Postman 컬렉션을 사용하려면 로컬로 다운로드한 다음, Postman을 통해 컬렉션을 가져옵니다. 이 컬렉션에 액세스하려면 Postman 컬렉션 예제를 참조하세요.