Mengakses API DICOMweb untuk mengelola data DICOM

Artikel
05/31/2024

Layanan DICOM® memungkinkan Anda menyimpan, meninjau, mencari, dan menghapus objek DICOM dengan menggunakan subset API DICOMweb. API DICOMweb adalah layanan berbasis web yang mengikuti standar DICOM. Dengan menggunakan API ini, Anda dapat mengakses dan mengelola data DICOM organisasi Tanpa memerlukan protokol atau format yang kompleks.

Layanan yang didukung adalah:

Simpan (STOW-RS): Unggah objek DICOM ke server.
Ambil (WADO-RS): Unduh objek DICOM dari server.
Pencarian (QIDO-RS): Temukan objek DICOM di server berdasarkan kriteria.
Hapus: Hapus objek DICOM dari server.
Worklist Service (UPS Push and Pull SOP): Mengelola dan melacak alur kerja pencitraan medis.

Selain subset API DICOMweb, layanan DICOM mendukung API kustom ini yang unik untuk Microsoft:

Umpan perubahan: Lacak perubahan pada data DICOM dari waktu ke waktu.
Tag kueri yang diperluas: Tentukan tag kustom untuk mengkueri data DICOM.
Pembaruan massal
Impor massal
Ekspor

Prasyarat

Sebarkan instans layanan DICOM. Untuk informasi selengkapnya, lihat Menyebarkan layanan DICOM menggunakan portal Azure.
Temukan URL Layanan Anda. Gunakan portal Azure untuk menavigasi ke instans layanan DICOM untuk menemukan URL Layanan. URL Layanan untuk mengakses layanan DICOM Anda menggunakan format ini: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Pastikan untuk menentukan versi sebagai bagian dari URL saat membuat permintaan. Untuk informasi selengkapnya, lihat Penerapan versi API untuk layanan DICOM.

Menggunakan metode REST API untuk berinteraksi dengan layanan DICOM

Layanan DICOM menyediakan antarmuka berbasis web yang mengikuti prinsip REST (transfer status representasi). REST API memungkinkan aplikasi atau sistem yang berbeda untuk berkomunikasi satu sama lain menggunakan metode standar seperti GET, POST, PUT, dan DELETE. Untuk berinteraksi dengan layanan DICOM, gunakan bahasa pemrograman apa pun yang mendukung permintaan dan respons HTTP.

Lihat contoh khusus bahasa. Anda dapat melihat contoh koleksi Postman dalam beberapa bahasa termasuk:

Go
Java
JavaScript
C#
PHP
C
NodeJS
Objective-C
OCaml
PowerShell
Python
Ruby
Swift

C#

Lihat Menggunakan API Standar DICOMweb dengan C# untuk mempelajari cara menggunakan C# dengan layanan DICOM.

cURL

cURL adalah alat baris perintah umum untuk memanggil titik akhir web dan tersedia untuk sebagian besar sistem operasi. Untuk memulai, unduh cURL.

Untuk mempelajari cara menggunakan cURL dengan layanan DICOM, lihat Menggunakan API Standar DICOMWeb™ dengan cURL.

Python

Untuk informasi selengkapnya tentang cara menggunakan Python dengan layanan DICOM, lihat Menggunakan API Standar DICOMWeb™ dengan Python.

Postman

Postman adalah alat yang sangat baik untuk merancang, membangun, dan menguji REST API. Unduh Postman untuk memulai. Untuk informasi selengkapnya, lihat Situs pembelajaran Postman.

Salah satu peringatan penting dengan Postman dan standar DICOMweb adalah Postman hanya mendukung pengunggahan file DICOM dengan menggunakan payload satu bagian yang ditentukan dalam standar DICOM. Peringatan ini karena Postman tidak dapat mendukung pemisah kustom dalam permintaan POST multipart/terkait. Untuk informasi selengkapnya, lihat POST Multipart tidak berfungsi untuk saya # 576. Semua contoh dalam koleksi Postman untuk mengunggah dokumen DICOM dengan menggunakan permintaan multibagian diawali dengan [tidak akan berfungsi - lihat deskripsi]. Contoh untuk mengunggah dengan menggunakan permintaan satu bagian disertakan dalam koleksi dan diawali dengan Store-Single-Instance.

Untuk menggunakan koleksi Postman, unduh secara lokal lalu impor koleksi melalui Postman. Untuk mengakses koleksi, lihat Contoh Koleksi Postman.

Langkah berikutnya

Menggunakan DICOMweb Standard API dengan C#

Menggunakan DICOMweb Standard API dengan cURL

Menggunakan API Standar DICOMweb dengan Python

Menggunakan DICOMWeb Standard API dengan Koleksi Contoh Postman

Pernyataan Kesuaian DICOM

Catatan

DICOM® adalah merek dagang terdaftar dari Asosiasi Produsen Listrik Nasional untuk publikasi Standar yang berkaitan dengan komunikasi digital informasi medis.

Bagikan melalui