Plantonizei

Integrações › Webhooks

Webhook do IDDoc

POST/api/v1/webhooks/iddocPública, sem sessão

Como funciona

Recebe os avisos do IDDoc, o serviço de consultas e de assinatura eletrônica. Não é para ser chamada por integração de cliente.

  • Cada aviso vem assinado: o cabeçalho X-NexusQuery-Assinatura traz sha256= com o HMAC do corpo, conferido em tempo constante com o segredo do webhook. Sem assinatura válida, 401.
  • O corpo tem até 64 KB.
  • O aviso só diz que algo mudou: a rota responde 200 na hora e relê o estado em segundo plano. Eventos assinatura.* atualizam os contratos e termos; eventos consulta.* concluem as verificações pendentes. Os outros são ignorados.

Parâmetros

  • eventoCorpo · stringEvento: `assinatura.*` ou `consulta.*`; os outros são ignorados.
  • dadosCorpo · object—
  • dados.idCorpo · stringIdentificador do documento ou da consulta no IDDoc.

Respostas

200 · Aviso recebido; o processamento segue em segundo plano.

Esta resposta não traz corpo.