O webhook permite que o Rdicom PACS avise seu sistema quando houver uma atualização de exame ou um laudo disponível. Você fornece um endereço do seu sistema para receber esses avisos.

Este serviço é opcional. Ele não muda o envio de agendamentos e não substitui automaticamente os webhooks que sua integração já utiliza.

Receber avisos do Rdicom PACS no seu sistema

Receber avisos do Rdicom PACS no seu sistema

O que você precisa fazer

  1. Prepare um endereço HTTPS público que aceite chamadas POST. Exemplo fictício: https://seusistema.exemplo/webhooks/rdicom.
  2. Envie esse endereço à Rdicom e combine os avisos que deseja receber.
  3. Receba a chave de assinatura pelo canal combinado. Essa chave é diferente do segredo usado para obter o token da API.
  4. Ao receber um aviso, confira a assinatura, guarde o aviso sem duplicá-lo e responda HTTP 200 rapidamente.
  5. Faça o processamento no seu sistema depois de confirmar o recebimento. Quando precisar de mais informações, consulte o exame pela API com seu token.
  6. Faça um teste conjunto com a Rdicom antes de ativar em produção.

Use um endereço na porta HTTPS padrão, sem senha, parâmetros de consulta ou redirecionamento. A URL é cadastrada pela equipe Rdicom; você não precisa chamar uma API administrativa.

Quais avisos posso receber?

Tipo O que significa
study.completed Aviso de exame concluído recebido pelo PACS.
study.updated Dados de um estudo foram atualizados.
study.deleted Um estudo foi excluído.
report.available Um documento de laudo ficou disponível.

A Rdicom confirma quais avisos estão disponíveis no seu ambiente. O serviço avisa novas ocorrências; não envia automaticamente todo o histórico anterior.

Exemplo do que seu sistema recebe

Seu endereço recebe um POST com JSON. Exemplo fictício:

{
  "version": "1",
  "event_id": "22222222-2222-4222-8222-222222222222",
  "type": "report.available",
  "occurred_at": "2026-11-07T15:00:00Z",
  "data": {
    "institution_id": 10,
    "server_id": 20,
    "study_instance_uid": "2.25.123456789"
  }
}

Este JSON é o aviso enviado pelo PACS, não o corpo para criar agendamentos. Ele não contém token de acesso, imagens ou o arquivo PDF.

Se o mesmo aviso chegar novamente

Guarde event_id junto da identificação do acesso configurado com a Rdicom. Se esse aviso já foi recebido e confirmado, responda 200 sem repetir a mesma ação. Avisos também podem chegar fora de ordem; consulte a situação atual do exame antes de atualizar seu sistema.