Acesse APIs DICOMweb com o serviço DICOM
O serviço DICOM permite armazenar, revisar, pesquisar e excluir objetos DICOM® usando um subconjunto de APIs DICOMweb, que 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 na nuvem 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.
Além do subconjunto de APIs DICOMweb, o serviço DICOM suporta duas 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. Use qualquer linguagem de programação que suporte solicitações e respostas HTTP para interagir com o serviço DICOM.
Para exemplos específicos de idioma, consulte os exemplos. Você pode ver exemplos de coleções Postman em vários idiomas, incluindo:
- 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 o cURL com o serviço DICOM, consulte o tutorial Usando APIs padrão DICOMWeb™ com cURL .
Python
Consulte o tutorial Usando APIs padrão DICOMWeb™ com Python para aprender a usar Python com o serviço DICOM.
Postman
O Postman é uma excelente ferramenta para projetar, construir e testar APIs REST. Faça o download do Postman para começar. Saiba como usar o Postman no site de aprendizagem Postman.
Uma ressalva 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. Esta razão deve-se ao facto de o Postman não poder suportar separadores personalizados num pedido POST com várias partes/relacionado. 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, você precisa baixar a coleção localmente e importá-la através do Postman. Para acessar essa coleção, consulte Exemplos de coleção Postman.
Próximos passos
Confira estes exemplos de como usar as APIs:
- Usando APIs padrão DICOMweb™ com C#
- Usando APIs padrão DICOMWeb™ com cURL
- Usando APIs padrão DICOMWeb™ com Python
- Use APIs padrão DICOMWeb™ com a Postman Example Collection
Saiba mais sobre o suporte da Microsoft para APIs DICOM Web Standard na 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.