A DICOMweb API-k elérése a DICOM szolgáltatással
A DICOM® szolgáltatás lehetővé teszi DICOM-objektumok tárolását, áttekintését, keresését és törlését a DICOMweb API-k egy részhalmazával, amelyek a DICOM szabványt követő webalapú szolgáltatások. Ezen API-k használatával összetett protokollok és formátumok nélkül érheti el és kezelheti a szervezet DICOM-adatait a felhőben.
A támogatott szolgáltatások a következők:
- Tároló (STOW-RS): DICOM-objektumok feltöltése a kiszolgálóra.
- Lekérés (WADO-RS): DICOM-objektumok letöltése a kiszolgálóról.
- Keresés (QIDO-RS): DICOM-objektumok keresése a kiszolgálón feltételek alapján.
- Törlés: DICOM-objektumok eltávolítása a kiszolgálóról.
A DICOMweb API-k részhalmazán kívül a DICOM szolgáltatás két, a Microsoft számára egyedi egyéni API-t is támogat:
- Változáscsatorna: A DICOM-adatok időbeli változásainak nyomon követése.
- Kiterjesztett lekérdezéscímkék: Egyéni címkék definiálása a DICOM-adatok lekérdezéséhez.
- Tömeges frissítés
- Tömeges importálás
- Exportálásálás
Előfeltételek
Telepítse a DICOM szolgáltatás egy példányát. További információ: A DICOM szolgáltatás üzembe helyezése az Azure Portalon.
Keresse meg a szolgáltatás URL-címét. Az Azure Portal használatával keresse meg a DICOM szolgáltatás példányát a szolgáltatás URL-címének megkereséséhez. A DICOM-szolgáltatás eléréséhez használt szolgáltatás URL-címe a következő formátumot használja:
https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com
. A kérések során mindenképpen adja meg a verziót az URL-cím részeként. További információ: API-verziószámozás a DICOM szolgáltatáshoz.
REST API-metódusok használata a DICOM szolgáltatással való interakcióhoz
A DICOM szolgáltatás egy webes felületet biztosít, amely a REST (reprezentációs állapotátvitel) alapelveit követi. A REST API lehetővé teszi, hogy a különböző alkalmazások vagy rendszerek szabványos módszerekkel kommunikáljanak egymással, például a GET, a POST, a PUT és a DELETE metódusokkal. Használjon minden olyan programozási nyelvet, amely támogatja a HTTP-kéréseket és -válaszokat a DICOM szolgáltatással való interakcióhoz.
Nyelvspecifikus példákért tekintse meg a példákat. A Postman-gyűjteményre vonatkozó példák több nyelven is megtekinthetők, például:
- Ugrás
- Java
- JavaScript
- C#
- PHP
- K
- NodeJS
- Objective-C
- OCaml
- PowerShell
- Python
- Ruby
- Swift
C#
A C# dicom szolgáltatással való használatához tekintse meg a DICOMweb Standard API-k C# használatával történő használatát.
cURL
A cURL egy gyakori parancssori eszköz a webes végpontok hívásához, és a legtöbb operációs rendszer számára elérhető. Első lépésként töltse le a cURL-t.
A cURL dicom szolgáltatással való használatáról további információt a DICOMWeb™ Standard API-k használata cURL-oktatóanyagban talál.
Python
A Python és a DICOM szolgáltatás használatával kapcsolatos tudnivalókért tekintse meg a DiCOMWeb™ Standard API-k használata Python-oktatóanyagot .
Postman
A Postman kiváló eszköz REST API-k tervezéséhez, készítéséhez és teszteléséhez. Első lépésként töltse le a Postmant . Megtudhatja, hogyan használhatja a Postmant a Postman képzési webhelyen.
A Postman és a DICOMweb Standard egyik fontos kikötése, hogy a Postman csak a DICOM szabványban meghatározott egyetlen rész hasznos adataival támogatja a DICOM-fájlok feltöltését. Ennek az az oka, hogy a Postman nem tudja támogatni az egyéni elválasztókat egy többrészes/kapcsolódó POST-kérelemben. További információ: Többrészes POST nem működik nekem # 576. A Postman-gyűjteményben a DICOM-dokumentumok többrészes kéréssel való feltöltésére szolgáló összes példa előtagja [nem fog működni – lásd a leírást]. Az egyrészes kérelem használatával történő feltöltésre vonatkozó példákat a gyűjtemény tartalmazza, és az egypéldányos tároló előtaggal rendelkezik.
A Postman-gyűjtemény használatához helyileg kell letöltenie a gyűjteményt, és importálnia kell a gyűjteményt a Postmanen keresztül. A gyűjtemény eléréséhez lásd a Postman-gyűjtemény példáit.
Következő lépések
Tekintse meg a következő példákat az API-k használatára:
- DICOMweb™ Standard API-k használata C-vel#
- DICOMWeb™ Standard API-k használata cURL-vel
- A DICOMWeb™ Standard API-k használata Pythonnal
- A DICOMWeb™ Standard API-k használata a Postman-példagyűjteménysel
A DICOM Webes Standard API-k Microsoft-támogatásáról a DICOM megfelelőségi nyilatkozatában olvashat bővebben.
Feljegyzés
A DICOM® az Országos Elektromos Gyártók Országos Szövetségének bejegyzett védjegye az orvosi információk digitális kommunikációjával kapcsolatos szabványügyi kiadványaihoz.