Acceso a las API de DICOMweb con el servicio DICOM
El servicio DICOM® permite almacenar, revisar, buscar y eliminar objetos DICOM mediante un subconjunto de API DICOMweb, que son servicios basados en web que siguen el estándar DICOM. Mediante estas API, puede acceder a los datos DICOM de la organización y administrarlos en la nube sin necesidad de protocolos o formatos complejos.
Los servicios admitidos son:
- Store (STOW-RS): cargue objetos DICOM en el servidor.
- Recuperar (WADO-RS): descargue objetos DICOM desde el servidor.
- Búsqueda (QIDO-RS): busque objetos DICOM en el servidor en función de criterios.
- Eliminar: quite objetos DICOM del servidor.
Además del subconjunto de API DICOMweb, el servicio DICOM admite dos API personalizadas exclusivas de Microsoft:
- Fuente de cambios: realice un seguimiento de los cambios en los datos DICOM a lo largo del tiempo.
- Etiquetas de consulta extendidas: defina etiquetas personalizadas para consultar datos DICOM.
- Realizar actualizaciones masivas
- Importación masiva
- Exportarar
Requisitos previos
Implemente una instancia del servicio DICOM. Para más información, consulte Implementación del servicio DICOM mediante Azure Portal.
Busque la dirección URL del servicio. Use Azure Portal para ir a la instancia del servicio DICOM para buscar la dirección URL del servicio. La dirección URL del servicio para acceder al servicio DICOM usa este formato:
https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com
. Asegúrese de especificar la versión como parte de la dirección URL al realizar solicitudes. Para más información, consulte Control de versiones de API para el servicio DICOM.
Uso de métodos de API REST para interactuar con el servicio DICOM
El servicio DICOM proporciona una interfaz basada en web que sigue los principios rest (transferencia de estado representacional). La API REST permite que diferentes aplicaciones o sistemas se comuniquen entre sí mediante métodos estándar como GET, POST, PUT y DELETE. Use cualquier lenguaje de programación que admita solicitudes HTTP y respuestas para interactuar con el servicio DICOM.
Para obtener ejemplos específicos del lenguaje, consulte los ejemplos. Puede ver ejemplos de colecciones de Postman en varios lenguajes, entre los que se incluyen:
- Go
- Java
- JavaScript
- C#
- PHP
- C
- NodeJS
- Objective-C
- OCaml
- PowerShell
- Python
- Ruby
- Swift
C#
Consulte Uso de las API estándar de DICOMweb con C# para obtener información sobre cómo usar C# con el servicio DICOM.
cURL
cURL es una herramienta de línea de comandos común para llamar a puntos de conexión web y está disponible para la mayoría de los sistemas operativos. Para empezar, descargue cURL.
Para obtener información sobre cómo usar cURL con el servicio DICOM, consulte Uso de API estándar DICOMWeb™ con cURL tutorial.
Python
Consulte el tutorial Uso de API estándar DICOMWeb™ con Python para aprender a usar Python con el servicio DICOM.
Postman
Postman es una excelente herramienta para diseñar, compilar y probar LAS API REST. Descargue Postman para empezar. Aprenda a usar Postman en el sitio de aprendizaje de Postman.
Una advertencia importante con Postman y el estándar DICOMweb es que Postman solo admite la carga de archivos DICOM mediante la carga de una sola pieza definida en el estándar DICOM. Este motivo se debe a que Postman no puede admitir separadores personalizados en una solicitud POST de varias partes o relacionadas. Para obtener más información, vea Multipart POST not working for me # 576. Todos los ejemplos de la colección Postman para cargar documentos DICOM mediante una solicitud de varias partes tienen el prefijo [no funcionará- ver descripción]. Los ejemplos de carga mediante una solicitud de un solo elemento se incluyen en la colección y tienen el prefijo Store-Single-Instance.
Para usar la colección de Postman, debe descargar la colección localmente e importarla a través de Postman. Para acceder a esta colección, consulte Ejemplos de colección de Postman.
Pasos siguientes
Consulte estos ejemplos de cómo usar las API:
- Uso de las API estándar de DICOMweb™ con C#
- Uso de LAS API estándar DICOMWeb™ con cURL
- Uso de LAS API estándar DICOMWeb™ con Python
- Uso de las API estándar DICOMWeb™ con la colección de ejemplo de Postman
Obtenga más información sobre la compatibilidad de Microsoft con las API de DICOM Web Standard en la instrucción de conformidad de DICOM.
Nota:
DICOM® es la marca registrada de la Asociación Nacional de Fabricantes Eléctricos para sus publicaciones de normas relacionadas con las comunicaciones digitales de información médica.