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:

• Archiviazione (STOW-RS): caricare oggetti DICOM nel server.
• Recupero (WADO-RS): scaricare oggetti DICOM dal server.
• Ricerca (QIDO-RS): trovare oggetti DICOM nel server in base ai criteri.
• Eliminazione: rimuovere gli oggetti DICOM dal server.
• Worklist Service (UPS Push e Pull SOPs): gestire e tenere traccia dei flussi di lavoro di diagnostica per immagini.

Oltre al subset di API DICOMweb, il servizio DICOM supporta queste API personalizzate esclusive per Microsoft:

• Feed di modifiche: tenere traccia delle modifiche apportate ai dati DICOM nel corso del 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 usando il portale di Azure.

• Trovare l'URL del servizio. Usare il 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 dell'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 rappresentativo). L'API REST consente ad 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 per ciascun linguaggio. È possibile visualizzare esempi di raccolta Postman in diversi linguaggi, tra cui i seguenti.

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

C#

Vedere Usare le API DICOMweb Standard con C# per informazioni su come usare C# con il servizio DICOM.

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 il sito per la formazione per Postman.

Per quanto riguarda Postman e lo standard DICOMweb, è importante notare che Postman supporta solo il caricamento di file DICOM con il payload a parte singola definito nello standard DICOM. Ciò è dovuto al fatto che Postman non può supportare separatori personalizzati in una richiesta POST a più parti/correlata. Per altre informazioni, vedere Il POST a più parti ha esito negativo # 576. Tutti gli esempi nella raccolta Postman per il caricamento di documenti DICOM tramite una richiesta a più parti sono preceduti da [won't work - see description]. Gli esempi per il caricamento tramite una richiesta a parte singola sono inclusi nella raccolta e sono preceduti da Store-Single-Instance.

Per usare la raccolta di Postman, scaricarla in locale e quindi importare la raccolta tramite Postman. Per accedere alla raccolta, vedere gli esempi di raccolte di Postman.

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 di Postman

Dichiarazione 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.