Klasik DICOM ağ servisleri (C-FIND, C-MOVE, C-STORE) 1990'ların hastane ağı için tasarlanmıştı: sabit IP'ler, açık portlar ve karşılıklı olarak tanımlanmış AE Title'lar gerektirir. Web uygulamaları bu modele uymaz. DICOMweb, aynı işlevleri HTTP üzerinden REST servisleriyle sunarak bu boşluğu kapatır.
Üç Temel Servis
| DICOMweb | Ne yapar? | Klasik karşılığı |
|---|---|---|
| QIDO-RS | Sorgular (çalışma, seri, örnek arar) | C-FIND |
| WADO-RS | Görüntü ve meta veriyi getirir | C-MOVE / C-GET |
| STOW-RS | Görüntü gönderir, arşive yazar | C-STORE |
QIDO-RS — Sorgulama
"Query based on ID for DICOM Objects" kısaltmasıdır. Standart HTTP sorgu parametreleriyle çalışma arar ve sonucu JSON olarak döndürür:
GET /dicomweb/studies?PatientID=12345&StudyDate=20260701-20260726
Dönen JSON, DICOM etiketlerini onaltılık anahtarlarla taşır. Bu sayede bir web arayüzü, arşivde arama yapmak için özel bir DICOM kütüphanesine ihtiyaç duymaz.
WADO-RS — Getirme
Görüntüyü ya da yalnızca meta veriyi çekmek için kullanılır. Üç yaygın kullanımı vardır:
GET /studies/{uid}/metadata— sadece etiketler, görüntü verisi olmadanGET /studies/{uid}/series/{uid}/instances/{uid}— DICOM nesnesinin tamamıGET /.../frames/1?accept=image/jpeg— doğrudan görüntülenebilir kare
Bir web viewer'ın hızlı açılmasının sırrı buradadır: önce meta veri çekilir, kesitler kullanıcı kaydırdıkça talep edilir. WADO'nun genel mantığını ayrı bir yazıda ele almıştık.
STOW-RS — Gönderme
"Store Over the Web" servisidir; multipart/related gövdeyle bir veya birden çok DICOM nesnesini arşive yazar. Mobil ultrason cihazları, yapay zekâ analiz sonuçları ve dış merkezden gelen görüntüler için pratik bir giriş kapısıdır.
Neden DICOMweb'e Geçilir?
- Güvenlik duvarı dostu: Yalnızca 443 portu yeterlidir; ek port açılmaz.
- Kimlik doğrulama: OAuth 2.0 / JWT gibi standart web mekanizmaları kullanılabilir.
- Geliştirici verimliliği: Herhangi bir dilde HTTP istemcisi yeterlidir.
- Bulut uyumu: Yük dengeleyiciler ve CDN'ler HTTP trafiğini doğal olarak yönetir.
- Kademeli geçiş: Mevcut C-STORE akışını bozmadan, yanına eklenerek devreye alınabilir.
Entegrasyonda Sık Yapılan Hatalar
- Transfer syntax pazarlığının atlanması: İstemcinin desteklemediği bir sıkıştırma döndürülürse görüntü açılmaz.
Acceptbaşlığı doğru kurgulanmalıdır. - Tüm çalışmanın tek seferde çekilmesi: Kesit kesit talep etmek yerine bütün seriyi indirmek, tarayıcı belleğini tüketir.
- Yetkilendirmenin viewer'a bırakılması: Erişim denetimi mutlaka sunucu tarafında, çalışma bazında yapılmalıdır.
- CORS başlıklarının unutulması: Viewer farklı bir alan adındaysa tarayıcı istekleri engeller.
SelfDICOM, WADO-URI, WADO-RS, QIDO-RS ve STOW-RS servislerinin tamamını destekler; mevcut PACS akışınızı bozmadan DICOMweb katmanını yanına ekleyebilirsiniz.
DICOMweb tabanlı bir entegrasyon planlıyorsanız teknik ekibimizle görüşebilirsiniz.