Få åtkomst till DICOMweb-API:er för att hantera DICOM-data

Med DICOM-tjänsten® kan du lagra, granska, söka efter och ta bort DICOM-objekt med hjälp av en delmängd dicomweb-API:er. DICOMweb-API:erna är webbaserade tjänster som följer DICOM-standarden. Med hjälp av dessa API:er kan du komma åt och hantera organisationens DICOM-data utan att kräva komplexa protokoll eller format.

Tjänsterna som stöds är:

• Store (STOW-RS): Ladda upp DICOM-objekt till servern.
• Hämta (WADO-RS): Ladda ned DICOM-objekt från servern.
• Sök (QIDO-RS): Hitta DICOM-objekt på servern baserat på kriterier.
• Ta bort: Ta bort DICOM-objekt från servern.
• Worklist Service (UPS Push and Pull SOPs): Hantera och spåra arbetsflöden för medicinsk avbildning.

Förutom delmängden av DICOMweb-API:er stöder DICOM-tjänsten dessa anpassade API:er som är unika för Microsoft:

• Ändringsflöde: Spåra ändringar i DICOM-data över tid.
• Utökade frågetaggar: Definiera anpassade taggar för att köra frågor mot DICOM-data.
• Massuppdatering
• Massimport
• Exporteraera

Förutsättningar

• Distribuera en instans av DICOM-tjänsten. Mer information finns i Distribuera DICOM-tjänsten med Azure Portal.

• Hitta din tjänst-URL. Använd Azure Portal för att navigera till instansen av DICOM-tjänsten för att hitta tjänst-URL:en. Tjänst-URL:en för att komma åt DICOM-tjänsten använder det här formatet: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Se till att ange versionen som en del av URL:en när du gör begäranden. Mer information finns i API-versionshantering för DICOM-tjänsten.

Använda REST API-metoder för att interagera med DICOM-tjänsten

DICOM-tjänsten tillhandahåller ett webbaserat gränssnitt som följer REST-principer (representationstillståndsöverföring). REST-API:et gör att olika program eller system kan kommunicera med varandra med hjälp av standardmetoder som GET, POST, PUT och DELETE. Om du vill interagera med DICOM-tjänsten använder du alla programmeringsspråk som stöder HTTP-begäranden och svar.

Se de språkspecifika exemplen. Du kan visa Postman-samlingsexempel på flera språk, inklusive följande.

• Kör
• Java
• JavaScript
• C#
• PHP
• C
• NodeJS
• Objective-C
• OCaml
• PowerShell
• Python
• Ruby
• Swift

C#

Se Använda DICOMweb Standard API:er med C# för att lära dig hur du använder C# med DICOM-tjänsten.

cURL

cURL är ett vanligt kommandoradsverktyg för att anropa webbslutpunkter och är tillgängligt för de flesta operativsystem. Kom igång genom att ladda ned cURL.

Information om hur du använder cURL med DICOM-tjänsten finns i Använda DICOMWeb™ Standard API:er med cURL.

Python

Mer information om hur du använder Python med DICOM-tjänsten finns i Använda DICOMWeb™ Standard-API:er med Python.

Postman

Postman är ett utmärkt verktyg för att utforma, skapa och testa REST-API:er. Ladda ned Postman för att komma igång. Mer information finns på postman-utbildningswebbplatsen.

En viktig varning med Postman och DICOMweb-standarden är att Postman endast stöder uppladdning av DICOM-filer med hjälp av endelsnyttolasten som definierats i DICOM-standarden. Det beror på att Postman inte kan stödja anpassade avgränsare i en postbegäran med flera delar/relaterade. Mer information finns i Multipart POST fungerar inte för mig # 576. Alla exempel i Postman-samlingen för att ladda upp DICOM-dokument med hjälp av en begäran med flera delar är prefixet [fungerar inte – se beskrivning]. Exemplen för uppladdning med hjälp av en endelsbegäran ingår i samlingen och är prefix med Store-Single-Instance.

Om du vill använda Postman-samlingen laddar du ned den lokalt och importerar sedan samlingen via Postman.

Nästa steg

Använda DICOMweb Standard-API:er med C#

Använda DICOMweb Standard-API:er med cURL

Använda DICOMweb Standard-API:er med Python

DICOM-överensstämmelseinstruklage

Kommentar

DICOM® är ett registrerat varumärke som tillhör National Electrical Manufacturers Association för dess standarder publikationer som rör digital kommunikation av medicinsk information.