存取 DICOMweb API 來管理 DICOM 數據

發行項
05/31/2024

DICOM® 服務可讓您使用 DICOMweb API 子集來儲存、檢閱、搜尋及刪除 DICOM 物件。 DICOMweb API 是遵循 DICOM 標準的 Web 服務。藉由使用這些 API，您可以存取和管理組織的 DICOM 數據，而不需要複雜的通訊協定或格式。

支援的服務如下：

儲存 (STOW-RS)：將 DICOM 對象上傳至伺服器。
擷取 (WADO-RS)：從伺服器下載 DICOM 物件。
搜尋 (QIDO-RS)：根據準則在伺服器上尋找 DICOM 物件。
刪除：從伺服器移除 DICOM 物件。
Worklist Service （UPS 推送和提取 SOP）：管理和追蹤醫療影像工作流程。

除了 DICOMweb API 的子集之外，DICOM 服務還支援 Microsoft 特有的這些自定義 API：

變更摘要：追蹤一段時間內 DICOM 資料的變更。
擴充查詢標籤：定義用於查詢 DICOM 資料的自訂標籤。
大量更新
大量匯入
匯出

必要條件

部署 DICOM 服務的執行個體。如需詳細資訊，請參閱使用 Azure 入口網站部署 DICOM 服務。
尋找您的服務 URL。使用 Azure 入口網站瀏覽至 DICOM 服務的執行個體，以尋找服務 URL。存取 DICOM 服務的服務 URL 會使用此格式：https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com。發出要求時，請務必將版本指定為 URL 的一部分。如需其他資訊，請參閱 DICOM 服務的 API 版本。

使用 REST API 方法來與 DICOM 服務互動

DICOM 服務提供了遵循 REST (具象狀態傳輸) 準則的 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#

請參閱搭配 C# 使用 DICOMweb 標準 API，以了解如何搭配 DICOM 服務使用 C#。

cURL

cURL 是呼叫 Web 端點的通用命令列工具，適用於大部分的作業系統。若要開始使用，請下載 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要求中支援自定義分隔符。如需詳細資訊，請參閱 Multipart POST not working for me # 576。使用多部分要求上傳 DICOM 檔的 Postman 集合中的所有範例都會加上 [無法運作 - 請參閱描述]。 使用單一部分要求上傳的範例會包含在集合中，並以 Store-Single-Instance 作為前置詞。

若要使用Postman集合，請在本機下載它，然後透過Postman匯入集合。若要存取集合，請參閱 Postman集合範例。