你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

访问 DICOMweb API 来管理 DICOM 数据

项目
01/17/2025

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 服务提供基于 Web 的接口，该接口遵循 REST（表述性状态转移）原则。 REST API 允许不同的应用程序或系统使用 GET、POST、PUT 和 DELETE 等标准方法相互通信。若要与 DICOM 服务交互，请使用支持 HTTP 请求和响应的任何编程语言。

请参阅语言特定的示例。可以使用多种语言查看 Postman 集合示例，包括以下语言。

Go
Java
JavaScript
C#
PHP
C
NodeJS
Objective-C
OCaml
PowerShell
Python
Ruby
Swift

C#

请参阅将 DICOMweb 标准 API 与 C# 配合使用，了解如何将 C# 与 DICOM 服务配合使用。

cURL

cURL 是用于调用 Web 终结点的常见命令行工具，适用于大多数操作系统。若要开始使用，请下载 cURL。

若要了解如何将 cURL 与 DICOM 服务配合使用，请参阅将 DICOMWeb™ 标准 API 与 cURL 配合使用。

Python

有关如何将 Python 与 DICOM 服务配合使用的详细信息，请参阅将 DICOMWeb™ 标准 API 与 Python 配合使用。

Postman

Postman 是用于设计、生成和测试 REST API 的优秀工具。下载 Postman 以开始使用。有关详细信息，请参阅 Postman 学习网站。

Postman 和 DICOMweb 标准的一个重要注意事项是，Postman 仅支持使用 DICOM 标准中定义的单部分有效负载上传 DICOM 文件。这是因为 Postman 无法在多部分/相关 POST 请求中支持自定义分隔符。有关详细信息，请参阅多部分 POST 不起作用 (# 576)。 Postman 集合中用于使用多部分请求上传 DICOM 文档的所有示例都以 [不起作用 - 请参阅说明] 作为前缀。使用单部分请求上传的示例包含在集合中，并带有 Store-Single-Instance 前缀。

若要使用 Postman 集合，请在本地下载该集合，然后通过 Postman 导入该集合。