存取 DICOMweb API，以管理 DICOM 資料

發行項
09/04/2024

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 入口網站部署 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 等標準方法彼此通訊。若要使用任何可支援 HTTP 要求和回應的程式設計語言，與 DICOM 服務互動。

請參閱特定語言的範例。您可以檢視數種語言的 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，請參閱使用 DICOMWeb™ 標準 API 搭配 cURL。

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。 Postman 集合中使用多部分要求上傳 DICOM 文件的所有範例前面都會加上 [無法運作 - 請參閱描述]。使用單一部分要求進行上傳的範例包含在集合中，而且前面加上 Store-Single-Instance。

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