Compartilhar via

Acessar APIs DICOMweb para gerenciar dados DICOM

  • Artigo

O serviço DICOM® permite que você armazene, examine, pesquise e exclua objetos DICOM usando um subconjunto de APIs DICOMweb. As APIs DICOMweb são serviços baseados na Web que seguem o padrão DICOM. Usando essas APIs, você pode acessar e gerenciar os dados de DICOM da sua organização sem precisar de protocolos ou formatos complexos.

Os serviços com suporte são:

Além do subconjunto de APIs DICOMweb, o serviço DICOM dá suporte a essas APIs personalizadas exclusivas da Microsoft:

Pré-requisitos

  • Implantar uma instância do serviço DICOM. Para obter mais informações, consulte Implantar o serviço DICOM usando o portal do Azure.

  • Localizar seu URL de Serviço. Use o portal do Azure para navegar até a instância do serviço DICOM para localizar a URL de Serviço. A URL de Serviço para acessar seu serviço DICOM usa este formato: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Especifique a versão como parte da URL ao fazer solicitações. Para obter mais informações, consulte Versão da API para o serviço DICOM.

Usar métodos de API REST para interagir com o serviço DICOM

O serviço DICOM fornece uma interface baseada na Web que segue os princípios REST (transferência de estado representacional). A API REST permite que diferentes aplicativos ou sistemas se comuniquem entre si usando métodos padrão como GET, POST, PUT e DELETE. Para interagir com o serviço DICOM, use qualquer linguagem de programação que dê suporte a solicitações e respostas HTTP.

Consulte os exemplos específicos do idioma. Você pode ver exemplos da coleção do Postman em várias linguagens, incluindo as seguintes.

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

C#

Consulte Usar APIs DICOMweb Standard com C# para saber como usar o C# com o serviço DICOM.

Curl

cURL é uma ferramenta de linha de comando comum para chamar pontos de extremidade da Web e está disponível para a maioria dos sistemas operacionais. Para começar, baixar cURL.

Para saber como usar cURL com o serviço DICOM, consulte Usando APIs padrão DICOMWeb™ com cURL.

Python

Para obter mais informações sobre como usar o Python com o serviço DICOM, consulte Como usar APIs padrão DICOMWeb™ com Python.

Postman

O Postman é uma excelente ferramenta para projetar, criar e testar APIs REST. Baixe o Postman para começar. Para obter mais informações, consulte site de aprendizagem do Postman.

Um aviso de cautela importante relacionado ao Postman e ao padrão DICOMweb é que o Postman só dá suporte ao upload de arquivos DICOM usando o conteúdo de uma única parte definido no padrão DICOM. Isso ocorre porque o Postman não pode dar suporte a separadores personalizados em uma solicitação POST multipart/related. Para obter mais informações, consulte Multipart POST não funcionando para mim nº 576. Todos os exemplos na coleção Postman para carregar documentos DICOM usando uma solicitação de várias partes são prefixados com [não funcionará - confira a descrição]. Os exemplos de carregamento usando uma solicitação de única parte são incluídos na coleção e são prefixados com Store-Single-Instance.

Para usar a coleção Postman, baixe-a localmente e importe a coleção por meio do Postman. Para acessar a coleção, consulte Exemplos da Coleção Postman.

Próximas etapas

Usar as APIs padrão do DICOMweb com C#

Usar as APIs Standard DICOMweb com cURL

Usar as APIs padrão do DICOMweb com Python

Usar APIs padrão DICOMWeb com a coleção de exemplos do Postman

Instrução de compatibilidade com DICOM

Observação

DICOM® é a marca registrada da National Electrical Manufacturers Association para suas publicações de padrões relacionados às comunicações digitais de informações médicas.