Acesse APIs DICOMweb para gerenciar dados DICOM

O serviço DICOM® permite armazenar, revisar, pesquisar e excluir 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 DICOM da sua organização sem exigir protocolos ou formatos complexos.

Os serviços suportados são:

• Store (STOW-RS): Carregue objetos DICOM para o servidor.
• Recuperar (WADO-RS): Baixe objetos DICOM do servidor.
• Pesquisa (QIDO-RS): Encontre objetos DICOM no servidor com base em critérios.
• Excluir: Remova objetos DICOM do servidor.
• Serviço de lista de trabalho (UPS Push and Pull SOPs): Gerencie e acompanhe fluxos de trabalho de geração de imagens médicas.

Além do subconjunto de APIs DICOMweb, o serviço DICOM suporta estas APIs personalizadas que são exclusivas da Microsoft:

• Feed de alterações: acompanhe as alterações nos dados DICOM ao longo do tempo.
• Tags de consulta estendidas: defina tags personalizadas para consultar dados DICOM.
• Atualização em massa
• Importação a granel
• Exportar

Pré-requisitos

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

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

Use 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 (representational state transfer). 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 suporte solicitações e respostas HTTP.

Consulte os exemplos específicos do idioma. Você pode ver exemplos de coleções do Postman em vários idiomas, incluindo os seguintes.

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

C#

Consulte Usar APIs padrão DICOMweb com C# para saber como usar C# com 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, faça o download do 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 Python com o serviço DICOM, consulte Usando APIs padrão DICOMWeb™ com Python.

Postman

O Postman é uma excelente ferramenta para projetar, construir e testar APIs REST. Faça o download do Postman para começar. Para obter mais informações, consulte Site de aprendizagem do Postman.

Um cuidado importante com o Postman e o padrão DICOMweb é que o Postman só suporta o upload de arquivos DICOM usando a carga útil de peça única definida no padrão DICOM. Isso ocorre porque o Postman não pode suportar separadores personalizados em uma solicitação POST com várias partes/relacionada. Para obter mais informações, consulte Multipart POST not working for me # 576. Todos os exemplos na coleção Postman para carregar documentos DICOM usando uma solicitação de várias partes são prefixados com [won't work - see description]. Os exemplos para upload usando uma solicitação de parte única estão incluídos na coleção e são prefixados com Store-Single-Instance.

Para usar a coleção Postman, baixe-a localmente e, em seguida, importe a coleção através do Postman. Para acessar a coleção, consulte Exemplos de coleção Postman.

Próximos passos

Usar APIs padrão DICOMweb com C#

Use APIs padrão DICOMweb com cURL

Use APIs padrão DICOMweb com Python

Use APIs padrão DICOMWeb com a Postman Example Collection

Declaração de conformidade DICOM

Nota

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