A DICOMweb API-k elérése a DICOM-adatok kezeléséhez
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. A DICOMweb API-k olyan webalapú szolgáltatások, amelyek a DICOM szabványt követik. Ezen API-k használatával összetett protokollok és formátumok megkövetelése nélkül érheti el és kezelheti a szervezet DICOM-adatait.
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.
- Worklist service (UPS Push and Pull SOP): Orvosi képalkotó munkafolyamatok kezelése és nyomon követése.
A DICOMweb API-k részhalmazán kívül a DICOM szolgáltatás a Microsoft számára egyedi egyéni API-kat is támogatja:
- 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. A DICOM szolgáltatással való interakcióhoz használjon minden olyan programozási nyelvet, amely támogatja a HTTP-kéréseket és -válaszokat.
Tekintse meg a nyelvspecifikus példákat. A Postman-gyűjteményre vonatkozó példák több nyelven is megtekinthetők, többek között az alábbiakban.
- Ugrás
- Java
- JavaScript
- C#
- PHP
- C
- 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 a cURL használatával című témakörben talál.
Python
A Python DICOM szolgáltatással való használatáról további információt a DICOMWeb™ Standard API-k Pythonnal való használata című témakörben talál.
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 . További információkért lásd a Postman képzési webhelyét.
A Postman és a DICOMweb szabvány egyik fontos figyelmeztetése, hogy a Postman csak a DICOM szabványban meghatározott egyrészes hasznos adatok használatával 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 töltse le helyileg, majd importálja 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
DICOMweb Standard API-k használata C-vel#
DICOMweb Standard API-k használata cURL-vel
DICOMweb Standard API-k használata Pythonnal
A DICOMWeb Standard API-k használata a Postman-példagyűjteménysel
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.