Teilen über

Zugreifen auf DICOMweb-APIs zum Verwalten von DICOM-Daten

  • Artikel

Mit dem DICOM-Dienst können Sie DICOM-Objekte® mithilfe einer Teilmenge von DICOMweb-APIs speichern, überprüfen, suchen und löschen. Die DICOMweb-APIs sind webbasierte Dienste, die dem DICOM-Standard entsprechen. Mithilfe dieser APIs können Sie auf DICOM-Daten Ihrer Organisation zugreifen und diese verwalten, ohne dass komplexe Protokolle oder Formate erforderlich sind.

Die unterstützten Dienste sind:

Zusätzlich zur Teilmenge der DICOMweb-APIs unterstützt der DICOM-Dienst diese benutzerdefinierten APIs, die für Microsoft eindeutig sind:

Voraussetzungen

  • Stellen Sie eine Instanz des DICOM-Diensts bereit. Weitere Informationen finden Sie unter Bereitstellen des DICOM-Diensts mithilfe des Azure-Portals.

  • Suchen nach der Dienst-URL. Verwenden Sie das 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. Um mit dem DICOM-Dienst zu interagieren, verwenden Sie jede Programmiersprache, die HTTP-Anforderungen und -Antworten unterstützt.

Beziehen Sie sich auf die sprachspezifischen Beispiele. Sie können Postman-Sammlungsbeispiele in mehreren Sprachen anzeigen, darunter:

  • Go
  • Java
  • JavaScript
  • C#
  • PHP
  • K
  • 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. cURL herunterladen, um zu beginnen.

Informationen zur Verwendung von cURL mit dem DICOM-Dienst finden Sie unter Verwenden von DICOMWeb™ Standard-APIs mit cURL.

Python

Weitere Informationen zur Verwendung von Python mit dem DICOM-Dienst finden Sie unter Verwenden von DICOMWeb™ Standard-APIs mit Python.

Postman

Postman ist ein hervorragendes Tool zum Entwerfen, Erstellen und Testen von REST-APIs. Postman herunterladen, um zu beginnen. Weitere Informationen finden Sie auf der Postman-Lernwebsite.

Eine wichtige Einschränkung bei Postman und dem DICOMweb-Standard besteht darin, dass Postman das Hochladen von DICOM-Dateien nur mithilfe der im DICOM-Standard definierten einzelteiligen Nutzlast unterstützt. Diese Einschränkung liegt daran, dass Postman benutzerdefinierte Trennzeichen in einer mehrteiligen/verwandten POST-Anforderung nicht unterstützen kann. Weitere Informationen finden Sie unter Multipart POST funktioniert bei mir nicht Nr. 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] versehen. Die Beispiele für das Hochladen mithilfe einer einzelteiligen Anforderung sind in der Sammlung enthalten und mit dem Präfix Store-Single-Instance versehen.

Um die Postman-Sammlung zu verwenden, laden Sie sie lokal herunter, und importieren Sie die Sammlung dann über Postman. Informationen zum Zugriff auf die Auflistung finden Sie unter Postman-Auflistungsbeispiele.

Nächste Schritte

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

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.