英語で読む

次の方法で共有

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

  • [アーティクル]

DICOM® サービスでは、DICOMweb API のサブセットを使用して、DICOM オブジェクトを格納、レビュー、検索、および削除できます。 DICOMweb API は、DICOM 標準に準拠した Web ベースのサービスです。 これらの API を使用すると、複雑なプロトコルや形式を必要とせずに、組織の 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) の原則に準拠した 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 経由でコレクションをインポートします。

次のステップ

C# で DICOMweb 標準 API を使用する

cURL で DICOMweb 標準 API を使用する

Python で DICOMweb 標準 API を使用する

DICOM 適合性宣言書

注意

DICOM® は、医療情報のデジタル通信に関する標準出版物に関する米国電機工業会 (National Electrical Manufacturers Association) の登録商標です。