Acceso a las API de DICOMweb para administrar datos DICOM
El servicio DICOM® permite almacenar, revisar, buscar y eliminar objetos DICOM mediante un subconjunto de API de DICOMweb. Las API de DICOMweb son servicios basados en web que siguen el estándar DICOM. Con estas API, puede acceder a los datos DICOM de su organización y administrarlos sin necesidad de protocolos o formatos complejos.
Los servicios admitidos son:
- Almacenar (STOW-RS): cargue objetos DICOM en el servidor.
- Recuperar (WADO-RS): descargue objetos DICOM desde el servidor.
- Buscar (QIDO-RS): busque objetos DICOM en el servidor en función de criterios.
- Eliminar: quite objetos DICOM del servidor.
- Servicio Worklist (insertar UPS and extraer SOP): administre y realice un seguimiento de los flujos de trabajo de creación de imágenes médicas.
Además del subconjunto de API de DICOMweb, el servicio DICOM admite estas API personalizadas que son 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 en bloque
- Exportarar
Requisitos previos
Implemente una instancia del servicio DICOM. Para obtener más información, consulte Implementación del servicio DICOM mediante Azure Portal.
Buscar 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 de 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 de REST permite que diferentes aplicaciones o sistemas se comuniquen entre sí mediante métodos estándar como GET, POST, PUT y DELETE. Para interactuar con el servicio DICOM, use cualquier lenguaje de programación que admita solicitudes y respuestas HTTP.
Consulte los ejemplos específicos del lenguaje. Puede ver ejemplos de colecciones de Postman en varios lenguajes, entre los que se incluyen los siguientes.
- 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.
Python
Para obtener más información sobre cómo usar Python con el servicio DICOM, consulte Uso de API estándar DICOMWeb™ con Python.
Postman
Postman es una excelente herramienta para diseñar, compilar y probar API de REST. Descargue Postman para empezar. Para obtener más información, consulte el sitio de aprendizaje de Postman.
Una precaución importante sobre Postman y el estándar DICOMweb es que Postman solo admite la carga de archivos DICOM mediante la carga de una sola parte definida en el estándar DICOM. Esta se debe a que Postman no puede admitir separadores personalizados en una solicitud POST de varias partes o relacionada. Para obtener más información, vea Multipart POST not working for me # 576 (POST de varias partes no funciona nº 576). Todos los ejemplos de la colección de Postman para cargar documentos DICOM mediante una solicitud de varias partes tienen el prefijo [no funcionará- ver descripción]. Los ejemplos para cargar 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, descárguelo localmente y, a continuación, importe la colección a través de Postman. Para acceder a la colección, consulte Ejemplos de colección de Postman.
Pasos siguientes
Usar API estándar de DICOMweb con C#
Usar API estándar de DICOMweb con cURL
Usar API estándar de DICOMweb con Python
Uso de las API estándar de DICOMWeb con la colección de ejemplo de Postman
Declaració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.