DICOM 서비스를 통해 DICOMweb API에 액세스

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

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

  • 저장(STOW-RS): DICOM 개체를 서버에 업로드합니다.
  • 찾기(WADO-RS): 서버에서 DICOM 개체를 다운로드합니다.
  • 검색(QIDO-RS): 조건에 따라 서버에서 DICOM 개체를 찾습니다.
  • 삭제: 서버에서 DICOM 개체를 제거합니다.

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

필수 조건

  • 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와 같은 표준 메서드를 사용하여 서로 통신할 수 있습니다. HTTP 요청 및 응답을 지원하는 모든 프로그래밍 언어를 사용하여 DICOM 서비스와 상호 작용할 수 있습니다.

예제에서 언어별 예를 참조하세요. 다음을 포함한 여러 언어로 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을 사용하는 방법을 알아보세요.

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

Postman 컬렉션을 사용하려면 컬렉션을 로컬로 다운로드하고 Postman을 통해 컬렉션을 가져와야 합니다. 이 컬렉션에 액세스하려면 Postman 컬렉션 예제를 참조하세요.

다음 단계

API를 사용하는 방법에 대한 다음 예제를 확인하세요.

DICOM 적합성 명세에서 DICOMweb 표준 API에 대한 Microsoft 지원에 관해 자세히 알아보세요.

참고 항목

DICOM®은 의료 정보의 디지털 통신과 관련된 표준 간행물에 대한 미국 전기공업회의 등록 상표입니다.