Accéder aux API DICOMweb pour gérer les données DICOM

Article
06/05/2024

Le service DICOM® vous permet de stocker, examiner, rechercher et supprimer des objets DICOM à l’aide d’un sous-ensemble d’API DICOMweb. Les API DICOMweb sont des services web qui suivent la norme DICOM. À l’aide de ces API, vous pouvez accéder aux données DICOM de votre organisation et les gérer sans nécessiter de protocoles ou de formats complexes.

Les services pris en charge sont les suivants :

Store (STOW-RS) : chargez des objets DICOM sur le serveur.
Récupérer (WADO-RS) : téléchargez des objets DICOM à partir du serveur.
Recherche (QIDO-RS) : recherchez des objets DICOM sur le serveur en fonction des critères.
Supprimer : supprimez les objets DICOM du serveur.
Service de liste de travail (UPS Push et Pull SOPs) : gérez et suivez les flux de travail d’imagerie médicale.

Outre le sous-ensemble d’API DICOMweb, le service DICOM prend en charge ces API personnalisées uniques à Microsoft :

Flux de modification : effectuez le suivi des modifications apportées aux données DICOM au fil du temps.
Balises de requête étendues : définissez des balises personnalisées pour interroger des données DICOM.
Mise à jour par lot
Importer en bloc
Export

Prérequis

Déployez une instance du service DICOM. Pour plus d’informations, consultez Déployer le service DICOM depuis le portail Azure.
Recherche de votre service. Utilisez le portail Azure pour accéder à l’instance du service DICOM pour rechercher l’URL du service. L’URL du service pour accéder à votre service DICOM utilise ce format : https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Veillez à spécifier la version dans l’URL quand vous effectuez des requêtes. Pour plus d’informations, consultez Contrôle de version d’API pour le service DICOM.

Utiliser des méthodes d’API REST pour interagir avec le service DICOM

Le service DICOM fournit une interface web qui suit les principes de transfert d’état représentationnel (representational state transfer, REST). L’API REST permet à différentes applications ou systèmes de communiquer entre eux à l’aide de méthodes standard telles que GET, POST, PUT et DELETE. Pour interagir avec le service DICOM, utilisez n’importe quel langage de programmation qui prend en charge les requêtes et réponses HTTP.

Voir les exemples propres à un langage particulier. Vous pouvez afficher des exemples de collection Postman dans plusieurs langues, notamment :

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

C#

Reportez-vous à l’utilisation des API DICOMweb Standard avec C# pour apprendre à utiliser C# avec le service DICOM.

cURL

cURL est un outil en ligne de commande courant pour appeler des points de terminaison web et est disponible pour la plupart des systèmes d’exploitation. Pour commencer, téléchargez cURL.

Pour savoir comment utiliser cURL avec le service DICOM, consultez Utilisation des API standard DICOMWeb™ avec cURL.

Python

Pour plus d’informations sur l’utilisation de Python avec le service DICOM, consultez Utilisation des API standard DICOMWeb™ avec Python.

Postman

Postman est un excellent outil pour la conception, la création et le test des API REST. Téléchargez Postman pour démarrer. Pour plus d’informations, consultez le site d’apprentissage Postman.

Une mise en garde importante avec Postman et la norme DICOMweb est que Postman prend uniquement en charge le chargement de fichiers DICOM à l’aide de la charge utile à composant unique définie dans la norme DICOM. Cette mise en garde est due au fait que Postman ne peut pas prendre en charge les séparateurs personnalisés dans une requête POST multipart/associée. Pour plus d’informations, voir Multipart POST ne fonctionne pas pour moi # 576. Tous les exemples de la collection Postman pour le chargement de documents DICOM à l’aide d’une requête multipart sont précédés de [ne fonctionne pas - voir description]. Les exemples de chargement à l’aide d’une requête en une seule partie sont inclus dans la collection et sont préfixés avec Store-Single-Instance.

Pour utiliser la collection Postman, téléchargez-la localement, puis importez la collection via Postman. Pour accéder à la collection, consultez Exemples de collection Postman.

Étapes suivantes

Utiliser des API Standard DICOMweb avec C#

Utiliser les API DICOMweb Standard avec cURL

Utilisez les API standard DICOMweb avec Python

Utiliser des API standard DICOMWeb avec l’exemple de collection Postman

Déclaration de conformité de DICOM

Remarque

DICOM® est une marque déposée de la National Electrical Manufacturers Association pour ses publications de standards relatifs aux communications numériques des informations médicales.

Partager via