Zugreifen auf DICOMweb-APIs mit dem DICOM-Dienst
Mit dem DICOM-Dienst können Sie DICOM-Objekte® mithilfe einer Teilmenge von DICOMweb-APIs speichern, überprüfen, suchen und löschen, die webbasierte Dienste sind, die dem DICOM-Standard entsprechen. Mithilfe dieser APIs können Sie auf DICOM-Daten Ihrer Organisation in der Cloud zugreifen und diese verwalten, ohne dass komplexe Protokolle oder Formate erforderlich sind.
Die unterstützten Dienste sind:
- Store (STOW-RS):: Laden Sie DICOM-Objekte auf den Server hoch.
- Retrieve (WADO-RS): Laden Sie DICOM-Objekte vom Server herunter.
- Suche (QIDO-RS): Suchen Sie DICOM-Objekte auf dem Server basierend auf Kriterien.
- Löschen: Entfernen Sie DICOM-Objekte vom Server.
Zusätzlich zur Teilmenge der DICOMweb-APIs unterstützt der DICOM-Dienst zwei benutzerdefinierte APIs, die für Microsoft eindeutig sind:
- Änderungsfeed: Nachverfolgen von Änderungen an DICOM-Daten im Laufe der Zeit.
- Erweiterte Abfragetags: Definieren benutzerdefinierter Tags zum Abfragen von DICOM-Daten.
- Sammelaktualisierung
- Massenimport
- Export
Voraussetzungen
Stellen Sie eine Instanz des DICOM-Diensts bereit. Weitere Informationen finden Sie unter Bereitstellen des DICOM-Diensts mit Azure-Portal.
Suchen Sie Ihre Dienst-URL. Verwenden Sie Azure-Portal, um zur Instanz des DICOM-Diensts zu navigieren, um die Dienst-URL zu finden. Die Dienst-URL für den Zugriff auf Ihren DICOM-Dienst verwendet dieses Format:
https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com
. Stellen Sie sicher, dass Sie die Version als Teil der URL angeben, wenn Sie Anforderungen stellen. Weitere Informationen finden Sie unter API-Versionsverwaltung für den DICOM-Dienst.
Verwenden von REST-API-Methoden für die Interaktion mit dem DICOM-Dienst
Der DICOM-Dienst stellt eine webbasierte Schnittstelle bereit, die auf REST-Prinzipien (Representational State Transfer) folgt. Die REST-API ermöglicht es verschiedenen Anwendungen oder Systemen, mit Standardmethoden wie GET, POST, PUT und DELETE miteinander zu kommunizieren. Verwenden Sie jede Programmiersprache, die HTTP-Anforderungen und -Antworten für die Interaktion mit dem DICOM-Dienst unterstützt.
Beispiele für sprachspezifische Beispiele finden Sie in den Beispielen. Sie können Postman-Sammlungsbeispiele in mehreren Sprachen anzeigen, darunter:
- Go
- Java
- JavaScript
- C#
- PHP
- C
- NodeJS
- Objective-C
- OCaml
- PowerShell
- Python
- Ruby
- Swift
C#
Weitere Informationen zur Verwendung von C# mit DICOMweb Standard-APIs finden Sie unter "Verwenden von C#" mit DICOM-Dienst.
cURL
cURL ist ein gängiges Befehlszeilentool zum Aufrufen von Webendpunkten und ist für die meisten Betriebssysteme verfügbar. Laden Sie cURL herunter, um zu beginnen.
Informationen zur Verwendung von cURL mit DICOM-Dienst finden Sie unter Verwenden von DICOMWeb™ Standard-APIs mit cURL-Lernprogramm .
Python
Lesen Sie die Verwendung von DICOMWeb™ Standard-APIs mit Python-Lernprogramm , um zu erfahren, wie Python mit dem DICOM-Dienst verwendet wird.
Postman
Postman ist ein hervorragendes Tool zum Entwerfen, Erstellen und Testen von REST-APIs. Laden Sie Postman herunter, um zu beginnen. Erfahren Sie, wie Sie Postman auf der Postman-Lernwebsite verwenden.
Eine wichtige Einschränkung bei Postman und dem DICOMweb Standard besteht darin, dass Postman nur das Hochladen von DICOM-Dateien mithilfe der im DICOM-Standard definierten Einzelteilnutzlast unterstützt. Dieser Grund liegt daran, dass Postman benutzerdefinierte Trennzeichen in einer mehrteiligen/verwandten POST-Anforderung nicht unterstützen kann. Weitere Informationen finden Sie unter Multipart POST nicht für mich # 576. Alle Beispiele in der Postman-Sammlung zum Hochladen von DICOM-Dokumenten mithilfe einer mehrteiligen Anforderung sind mit dem Präfix [funktioniert nicht - siehe Beschreibung]. Die Beispiele für das Hochladen mithilfe einer einzelteiligen Anforderung sind in der Sammlung enthalten und werden mit dem Präfix "Store-Single-Instance" versehen.
Um die Postman-Sammlung zu verwenden, müssen Sie die Sammlung lokal herunterladen und die Sammlung über Postman importieren. Informationen zum Zugriff auf diese Auflistung finden Sie unter Postman-Auflistungsbeispiele.
Nächste Schritte
Sehen Sie sich die folgenden Beispiele für die Verwendung der APIs an:
- Verwenden von DICOMweb™ Standard-APIs mit C#
- Verwenden von DICOMWeb™ Standard-APIs mit cURL
- Verwenden von DICOMWeb™ Standard-APIs mit Python
- Verwenden von DICOMWeb™ Standard-APIs mit der Postman-Beispielauflistung
Erfahren Sie mehr über die Microsoft-Unterstützung für DICOM Web Standard-APIs in der DICOM-Konformitätserklärung.
Hinweis
DICOM® ist die eingetragene Marke des National Electrical Manufacturers Association für seine Standards-Publikationen über die digitale Kommunikation medizinischer Informationen.