Accedere alle API DICOMweb per gestire i dati DICOM
Il servizio DICOM® consente di archiviare, esaminare, cercare ed eliminare oggetti DICOM usando un subset di API DICOMweb. Le API DICOMweb sono servizi basati sul Web che seguono lo standard DICOM. Usando queste API, è possibile accedere e gestire i dati DICOM dell'organizzazione senza richiedere protocolli o formati complessi.
I servizi supportati sono:
- Store (STOW-RS): caricare oggetti DICOM nel server.
- Recuperare (WADO-RS): scaricare oggetti DICOM dal server.
- Ricerca (QIDO-RS): trovare oggetti DICOM nel server in base ai criteri.
- Elimina: rimuovere gli oggetti DICOM dal server.
- Servizio Worklist (UPS Push and Pull SOPs): gestire e tenere traccia dei flussi di lavoro di imaging medico.
Oltre al subset di API DICOMweb, il servizio DICOM supporta queste API personalizzate univoche per Microsoft:
- Feed di modifiche: tenere traccia delle modifiche apportate ai dati DICOM nel tempo.
- Tag di query estesi: definire tag personalizzati per l'esecuzione di query sui dati DICOM.
- Aggiornamento in blocco
- Importazione in blocco
- Export
Prerequisiti
Distribuire un'istanza del servizio DICOM. Per altre informazioni, vedere Distribuire il servizio DICOM tramite portale di Azure.
Trovare l'URL del servizio. Usare portale di Azure per passare all'istanza del servizio DICOM per trovare l'URL del servizio. L'URL del servizio per accedere al servizio DICOM usa questo formato:
https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Assicurarsi di specificare la versione come parte dell'URL durante l'esecuzione di richieste. Per altre informazioni, vedere Controllo delle versioni delle API per il servizio DICOM.
Usare i metodi dell'API REST per interagire con il servizio DICOM
Il servizio DICOM fornisce un'interfaccia basata sul Web che segue i principi REST (trasferimento di stato rappresentazione). L'API REST consente a applicazioni o sistemi diversi di comunicare tra loro usando metodi standard come GET, POST, PUT e DELETE. Per interagire con il servizio DICOM, usare qualsiasi linguaggio di programmazione che supporti richieste e risposte HTTP.
Fare riferimento agli esempi specifici della lingua. È possibile visualizzare esempi di raccolta Postman in diverse lingue, tra cui:
- Go
- Java
- JavaScript
- C#
- PHP
- A
- NodeJS
- Objective-C
- OCaml
- PowerShell
- Python
- Ruby
- Swift
C#
cURL
cURL è uno strumento da riga di comando comune per chiamare gli endpoint Web ed è disponibile per la maggior parte dei sistemi operativi. Per iniziare, scaricare cURL.
Per informazioni su come usare cURL con il servizio DICOM, vedere Uso delle API DICOMWeb™ Standard con cURL.
Python
Per altre informazioni su come usare Python con il servizio DICOM, vedere Uso delle API DICOMWeb™ Standard con Python.
Postman
Postman è uno strumento eccellente per la progettazione, la compilazione e il test delle API REST. Scaricare Postman per iniziare. Per altre informazioni, vedere Sito di apprendimento postman.
Un aspetto importante con Postman e lo standard DICOMweb è che Postman supporta solo il caricamento di file DICOM usando il payload in una sola parte definito nello standard DICOM. Questo avviso è dovuto al fatto che Postman non può supportare separatori personalizzati in una richiesta POST multipart/correlata. Per altre informazioni, vedere Post multipart non funzionante per me n. 576. Tutti gli esempi nella raccolta Postman per il caricamento di documenti DICOM tramite una richiesta multipart sono preceduti da [non funzionerà- vedere la descrizione]. Gli esempi per il caricamento tramite una richiesta a singola parte sono inclusi nella raccolta e hanno il prefisso Store-Single-Instance.
Per usare la raccolta Postman, scaricarla in locale e quindi importare la raccolta tramite Postman. Per accedere alla raccolta, vedere Postman Collection Examples .To access the collection examples, see Postman Collection Examples.
Passaggi successivi
Usare le API DICOMweb Standard con C#
Usare le API DICOMweb Standard con cURL
Usare le API DICOMweb Standard con Python
Usare le API DICOMWeb Standard con la raccolta di esempi postman
Istruzione di conformità DICOM
Nota
DICOM® è il marchio registrato della National Electrical Manufacturers Association per le sue pubblicazioni Standard relative alle comunicazioni digitali delle informazioni mediche.