Accéder aux API DICOMweb avec le service DICOM

  • Article

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

Les services pris en charge sont les suivants :

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

Prérequis

  • Déployez une instance du service DICOM. Pour plus d’informations, consultez Déployer le service DICOM à l’aide de Portail Azure.

  • Recherchez votre URL de service. Utilisez 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 le cadre de l’URL lors d’une demande. 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 rest (transfert d’état représentationnel). 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. Utilisez n’importe quel langage de programmation qui prend en charge les requêtes et réponses HTTP pour interagir avec le service DICOM.

Pour obtenir des exemples spécifiques au langage, reportez-vous aux exemples. 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 le didacticiel cURL .

Python

Reportez-vous au didacticiel Utilisation des API DICOMWeb™ Standard avec Python pour apprendre à utiliser Python avec le service DICOM.

Postman

Postman est un excellent outil pour la conception, la création et le test des API REST. Téléchargez Postman pour commencer. Découvrez comment utiliser Postman sur le site d’apprentissage Postman.

Une mise en garde importante avec Postman et DICOMweb Standard est que Postman prend uniquement en charge le chargement de fichiers DICOM à l’aide de la charge utile de partie unique définie dans la norme DICOM. C’est pourquoi 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 à composant unique sont inclus dans la collection et sont préfixés avec Store-Single-Instance.

Pour utiliser la collection Postman, vous devez télécharger la collection localement et importer la collection via Postman. Pour accéder à cette collection, consultez Exemples de collection Postman.

Étapes suivantes

Consultez ces exemples d’utilisation des API :

En savoir plus sur la prise en charge microsoft des API standard web DICOM dans l’instruction de conformité 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.