DICOMweb Standard API-k használata cURL-vel

Cikk
09/01/2024

Ez a cikk bemutatja, hogyan használhatja a DICOMweb szolgáltatást cURL és minta .dcm DICOM-fájlok® használatával.

Használja az alábbi mintafájlokat:

blue-circle.dcm
dicom-metadata.csv
green-square.dcm
red-triangle.dcm

A minta DICOM-fájlok fájlneve, studyUID, seriesUID és instanceUID azonosítója a következő:

Fájl	StudyUID	SeriesUID	InstanceUID
green-square.dcm	1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420	1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652	1.2.826.0.1.3680043.8.498.12714725698140337137334606354172323212
red-triangle.dcm	1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420	1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652	1.2.826.0.1.3680043.8.498.47359123102728459884412887463296905395
blue-circle.dcm	1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420	1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207	1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

Feljegyzés

Ezek a fájlok egyetlen példányt jelölnek, és ugyanahhoz a tanulmányhoz tartoznak. A zöld négyzet és a piros háromszög is ugyanahhoz a sorozathoz tartozik, míg a kék kör külön sorozatban van.

Előfeltételek

A DICOM Standard API-k használatához üzembe kell helyeznie 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.

A DICOM szolgáltatás egy példányának üzembe helyezése után kérje le az App Service URL-címét.

Jelentkezzen be az Azure Portalra.
Keressen a legutóbbi erőforrások között, és válassza ki a DICOM szolgáltatáspéldányt.
Másolja ki a DICOM-szolgáltatás szolgáltatás URL-címét .
Ha hozzáférési jogkivonatra van szüksége, olvassa el a HOZZÁFÉRÉSI jogkivonat lekérése a DICOM szolgáltatáshoz című témakört.

Ehhez a kódhoz egy nyilvános előzetes verziójú Azure-szolgáltatást értünk el. Fontos, hogy ne töltsön fel privát egészségügyi adatokat (PHI).

A DICOM szolgáltatással végzett munka

A DICOMweb Standard a HTTP-kérések és a multipart/related DICOM-specifikus elfogadási fejlécek együttes használatát teszi lehetővé. A többi REST-alapú API-t ismerő fejlesztők gyakran kínosnak találják a DICOMweb Standard használatát. A használat után azonban könnyen használható. Csak egy kis ismerősség kell az első lépésekhez.

A cURL-parancsok mindegyike legalább egy, néha két változót tartalmaz, amelyeket ki kell cserélni. A parancsok futtatásának egyszerűsítése érdekében keresse meg és cserélje le az alábbi változókat az adott értékekre.

{Szolgáltatás URL-címe} A szolgáltatás URL-címe az Azure Portalon kiépített DICOM-szolgáltatás eléréséhez szükséges URL-cím, https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.compéldául. A kérések során győződjön meg arról, hogy az URL-cím részeként adja meg a verziót. További információt a DICOM szolgáltatás dokumentációjának API-verziószámozásában talál.
{path-to-dicoms} – A red-triangle.dcm fájlt tartalmazó könyvtár elérési útja, például C:/dicom-server/docs/dcms
- Ügyeljen arra, hogy a perjelek elválasztóként legyenek használva, és záró perjel nélkül fejezhesse be a könyvtárat.

DICOM-példányok feltöltése (STOW)

Többrészes/kapcsolódó példányok tárolása

Ez a kérés bemutatja, hogyan tölthet fel DICOM-fájlokat többrészes/kapcsolódó használatával.

Feljegyzés

A DICOM szolgáltatás megengedőbb, mint a DICOM szabvány. A példa azonban egy olyan POST-kérést mutat be, amely szigorúan megfelel a szabványnak.

Részletek:

Ösvény:.. /Tanulmányok
Metódus: POST
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"
- Engedélyezés: Tulajdonos {token value}
Test:
- Tartalomtípus: alkalmazás/dicom minden feltöltött fájlhoz, határértékel elválasztva

Egyes programozási nyelvek és eszközök eltérően viselkednek. Egyes esetekben például meg kell határoznia a saját határait. Ezekben az eszközökben előfordulhat, hogy kissé módosított tartalomtípusú fejlécet kell használnia. Az alábbi eszközök sikeresen használhatók.

Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó

curl --location --request POST "{Service URL}/v{version}/studies"
--header "Accept: application/dicom+json"
--header "Content-Type: multipart/related; type=\"application/dicom\""
--header "Authorization: Bearer {token value}"
--form "file1=@{path-to-dicoms}/red-triangle.dcm;type=application/dicom"
--trace-ascii "trace.txt"

Adott tanulmány példányainak tárolása

Ez a kérés bemutatja, hogyan tölthet fel DICOM-fájlokat többrészes/egy kijelölt tanulmányhoz kapcsolódóan.

Részletek:

Ösvény:.. /studies/{study}
Metódus: POST
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"
- Engedélyezés: Tulajdonos {token value}
Test:
- Tartalomtípus: alkalmazás/dicom minden feltöltött fájlhoz, határértékel elválasztva

Egyes programozási nyelvek és eszközök eltérően viselkednek. Egyes esetekben például meg kell határoznia a saját határait. Ezekben a nyelvekben és eszközökben előfordulhat, hogy kissé módosított tartalomtípus-fejlécet kell használnia. Az alábbi eszközök sikeresen használhatók.

Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó

curl --request POST "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420"
--header "Accept: application/dicom+json"
--header "Content-Type: multipart/related; type=\"application/dicom\""
--header "Authorization: Bearer {token value}"
--form "file1=@{path-to-dicoms}/blue-circle.dcm;type=application/dicom"

Egypéldányos tároló

Feljegyzés

Ez egy nem szabványos API, amely lehetővé teszi egyetlen DICOM-fájl feltöltését anélkül, hogy konfigurálnia kellene a POST-et a többrészes/kapcsolódó fájlokhoz. Bár a cURL jól kezeli a többrészes/kapcsolódó elemeket, ez az API lehetővé teszi, hogy a Postmanhez hasonló eszközök fájlokat töltsenek fel a DICOM szolgáltatásba.

Egyetlen DICOM-fájl feltöltéséhez a következő módszer szükséges.

Részletek:

Ösvény:.. /Tanulmányok
Metódus: POST
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: alkalmazás/dicom
- Engedélyezés: Tulajdonos {token value}
Test:
- Bináris bájtként egyetlen DICOM-fájlt tartalmaz.

curl --location --request POST "{Service URL}/v{version}/studies"
--header "Accept: application/dicom+json"
--header "Content-Type: application/dicom"
--header "Authorization: Bearer {token value}"
--data-binary "@{path-to-dicoms}/green-square.dcm"

Többrészes/kapcsolódó példányok upsert használata

Feljegyzés

Ez egy nem szabványos API, amely lehetővé teszi a DICOM-fájlok többrészes/kapcsolódó használatával történő frissítését.

Részletek:

Ösvény:.. /Tanulmányok
Módszer: PUT
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"
- Engedélyezés: Tulajdonos {token value}
Test:
- Tartalomtípus: alkalmazás/dicom minden feltöltött fájlhoz, határértékel elválasztva

Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó

curl --location --request PUT "{Service URL}/v{version}/studies"
--header "Accept: application/dicom+json"
--header "Content-Type: multipart/related; type=\"application/dicom\""
--header "Authorization: Bearer {token value}"
--form "file1=@{path-to-dicoms}/red-triangle.dcm;type=application/dicom"
--trace-ascii "trace.txt"

Upsert-példányok egy adott tanulmányhoz

Feljegyzés

Ez egy nem szabványos API, amely lehetővé teszi a DICOM-fájlok frissítését többrészes/egy kijelölt tanulmányhoz kapcsolódó használatával.

Részletek:

Ösvény:.. /studies/{study}
Módszer: PUT
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"
- Engedélyezés: Tulajdonos {token value}
Test:
- Tartalomtípus: alkalmazás/dicom minden feltöltött fájlhoz, határértékel elválasztva

Tartalomtípus: többrészes/kapcsolódó; type="application/dicom"; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó; boundary=ABCD1234
Tartalomtípus: többrészes/kapcsolódó

curl --request PUT "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420"
--header "Accept: application/dicom+json"
--header "Content-Type: multipart/related; type=\"application/dicom\""
--header "Authorization: Bearer {token value}"
--form "file1=@{path-to-dicoms}/blue-circle.dcm;type=application/dicom"

Egypéldányos upsert

Feljegyzés

Ez egy nem szabványos API, amely lehetővé teszi egyetlen DICOM-fájl frissítését.

Ezzel a módszerrel egyetlen DICOM-fájlt tölthet fel.

Részletek:

Ösvény:.. /Tanulmányok
Módszer: PUT
Fejlécek:
- Elfogadás: application/dicom+json
- Tartalomtípus: alkalmazás/dicom
- Engedélyezés: Tulajdonos {token value}
Test:
- Bináris bájtként egyetlen DICOM-fájlt tartalmaz.

curl --location --request PUT "{Service URL}/v{version}/studies"
--header "Accept: application/dicom+json"
--header "Content-Type: application/dicom"
--header "Authorization: Bearer {token value}"
--data-binary "@{path-to-dicoms}/green-square.dcm"

DICOM (WADO) lekérése

Egy tanulmány összes példányának lekérése

Ez a kérés egyetlen tanulmány összes példányát lekéri, és többrészes/kapcsolódó bájtok gyűjteményeként adja vissza őket.

Részletek:

Ösvény:.. /studies/{study}
Metódus: GET
Fejlécek:
- Elfogadás: többrészes/kapcsolódó; type="application/dicom"; transfer-szintaxis=*
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420"
--header "Accept: multipart/related; type=\"application/dicom\"; transfer-syntax=*"
--header "Authorization: Bearer {token value}"
--output "suppressWarnings.txt"

Ez a cURL-parancs a kimeneti fájlban (suppressWarnings.txt) jeleníti meg a letöltött bájtokat, de nem közvetlen DICOM-fájlok, csak a többrészes/kapcsolódó letöltés szöveges ábrázolása.

A vizsgált példányok metaadatainak lekérése

Ez a kérés egyetlen tanulmány összes példányának metaadatait kéri le.

Részletek:

Ösvény:.. /studies/{study}/metadata
Metódus: GET
Fejlécek:
- Elfogadás: application/dicom+json
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/metadata"
--header "Accept: application/dicom+json"
--header "Authorization: Bearer {token value}"

Egy sorozat összes példányának lekérése

Ez a kérés egyetlen sorozat összes példányát lekéri, és többrészes/kapcsolódó bájtok gyűjteményeként adja vissza őket.

Részletek:

Ösvény:.. /studies/{study}/series/{series}
Metódus: GET
Fejlécek:
- Elfogadás: többrészes/kapcsolódó; type="application/dicom"; transfer-szintaxis=*
- Engedélyezés: Tulajdonos {token value}

Ez a cURL-parancs a kimeneti fájlban (suppressWarnings.txt) jeleníti meg a letöltött bájtokat, de nem a DICOM-fájl, csak a többrészes/kapcsolódó letöltés szöveges ábrázolása.

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652"
--header "Accept: multipart/related; type=\"application/dicom\"; transfer-syntax=*"
--header "Authorization: Bearer {token value}"
--output "suppressWarnings.txt"

Egy sorozat összes példányának metaadatainak lekérése

Ez a kérés egyetlen tanulmány összes példányának metaadatait kéri le.

Részletek:

Ösvény:.. /studies/{study}/series/{series}/metadata
Metódus: GET
Fejlécek:
- Elfogadás: application/dicom+json
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/metadata"
--header "Accept: application/dicom+json"
--header "Authorization: Bearer {token value}"

Egyetlen példány lekérése egy tanulmánysorozaton belül

Ez a kérés egyetlen példányt kér le, és DICOM formátumú bájtos adatfolyamként adja vissza.

Részletek:

Ösvény:.. /studies/{study}/series{series}/instances/{instance}
Metódus: GET
Fejlécek:
- Elfogadás: application/dicom; transfer-szintaxis=*
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/instances/1.2.826.0.1.3680043.8.498.47359123102728459884412887463296905395"
--header "Accept: application/dicom; transfer-syntax=*"
--header "Authorization: Bearer {token value}"
--output "suppressWarnings.txt"

Egyetlen példány metaadatainak lekérése egy tanulmánysorozaton belül

Ez a kérés egyetlen példány metaadatait kéri le egyetlen tanulmányon és sorozaton belül.

Részletek:

Ösvény:.. /studies/{study}/series/{series}/instances/{instance}/metadata
Metódus: GET
Fejlécek:
- Elfogadás: application/dicom+json
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/instances/1.2.826.0.1.3680043.8.498.47359123102728459884412887463296905395/metadata"
--header "Accept: application/dicom+json"
--header "Authorization: Bearer {token value}"

Egy vagy több keret lekérése egyetlen példányból

Ez a kérés egy vagy több képkockát kér le egyetlen példányból, és többrészes/kapcsolódó bájtok gyűjteményeként adja vissza őket. Több képkockát is lekérhet a keretszámok vesszővel tagolt listájának megadásával. A képeket tartalmazó DICOM-példányok mindegyike legalább egy kerettel rendelkezik, ami gyakran csak a példányhoz társított kép.

Részletek:

Ösvény:.. /studies/{study}/series{series}/instances/{instance}/frames/1,2,3
Metódus: GET
Fejlécek:
- Elfogadás: többrészes/kapcsolódó; type="application/octet-stream"; transfer-szintaxis=1.2.840.10008.1.2.1 (Alapértelmezett) vagy
- Elfogadás: többrészes/kapcsolódó; type="application/octet-stream"; transfer-szintaxis=* vagy
- Elfogadás: többrészes/kapcsolódó; type="application/octet-stream";
- Engedélyezés: Tulajdonos {token value}

curl --request GET "{Service URL}/v{version}/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/instances/1.2.826.0.1.3680043.8.498.47359123102728459884412887463296905395/frames/1"
--header "Accept: multipart/related; type=\"application/octet-stream\"; transfer-syntax=1.2.840.10008.1.2.1"
--header "Authorization: Bearer {token value}"
--output "suppressWarnings.txt"

Lekérdezési DICOM (QIDO)

Az alábbi példákban egyedi azonosítókkal keresünk elemeket. Más attribútumokat is kereshet, például PatientName.