DICOMweb API にアクセスして DICOM データを管理する

[アーティクル]
2025/01/17

DICOM® サービスでは、DICOMweb API のサブセットを使用して、DICOM オブジェクトを格納、レビュー、検索、および削除できます。 DICOMweb API は、DICOM 標準に準拠した Web ベースのサービスです。これらの 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) の原則に準拠した Web ベースのインターフェイスを提供します。 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 は、Web エンドポイントを呼び出すための一般的なコマンドラインツールであり、ほとんどのオペレーティングシステムで使用できます。使用を開始するには、cURL をダウンロードします。

DICOM サービスで cURL を使用する方法については、「cURL での DICOMWeb™ 標準 API の使用」を参照してください。

Python

DICOM サービスで Python を使用する方法の詳細については、「Python での DICOMWeb™ 標準 API の使用」を参照してください。

Postman

Postman は、REST API の設計、ビルド、テストに最適なツールです。 Postman をダウンロードして作業を開始します。詳細については、Postman の学習サイトを参照してください。

Postman と DICOMweb 標準の重要な注意事項の 1 つは、Postman が DICOM 標準で定義されている単一部ペイロードを使用した DICOM ファイルのアップロードのみをサポートすることです。これは、Postman がマルチパートまたは関連の POST 要求でカスタム区切り記号をサポートできないためです。詳細については、「Multipart POST not working for me #576」を参照してください。 Postman コレクションにある、multipart の要求を使用して DICOM ドキュメントをアップロードする例にはすべて、[won't work - see description] (動作しません - 説明を参照してください) というプレフィックスが付いています。単一部の要求を使用してアップロードする例はコレクションに含まれており、Store-Single-Instance というプレフィックスが付いています。

Postman コレクションを使用するには、ローカルにダウンロードし、Postman 経由でコレクションをインポートします。