Webhooks

Em vez de consultar a API de tempos em tempos, receba um aviso no seu sistema quando algo acontece no Nottun.

Consultar a API de minuto em minuto para descobrir se algo mudou é caro e lento. O webhook inverte isso: o Nottun avisa o seu sistema quando o evento acontece.

Como funciona

Você registra um endereço do seu sistema que aceita requisições. Quando o evento assinado acontece, o Nottun envia os dados para lá.

Entregas

Cada envio é registrado como uma entrega, com o resultado. Isso permite responder à pergunta que toda integração faz mais cedo ou mais tarde: o aviso foi enviado e o meu sistema não processou, ou ele nunca chegou?

Entregas que falharam podem ser reenviadas.

O que o seu sistema precisa fazer

Responder rápido. Processamento demorado deve acontecer depois de confirmar o recebimento, e não durante ele.
Ser idempotente. Um mesmo evento pode chegar mais de uma vez, e processar duas vezes não pode gerar dois registros.
Aceitar campos novos sem quebrar. A carga do evento pode ganhar informação com o tempo.

Segurança

Publique um endereço dedicado ao recebimento, sob HTTPS, e valide a origem antes de processar.

Requisito de plano

Os webhooks fazem parte do recurso de integrações do plano, junto com a API.