Skip to main content
@rewritetoday/fastify e o adapter da Rewrite para servicos Fastify que preferem registrar webhooks no formato de plugin. Repositorio: github.com/RewriteToday/adapters

Quando usar

  • Quando seu servico ja usa Fastify e seu modelo de plugins.
  • Quando quer que o registro do webhook respeite os limites de encapsulamento do Fastify.
  • Quando prefere callbacks tipados a validacao de assinatura e parse manual do payload.
  • Quando quer que o adapter registre o comportamento de parser necessario para validar webhooks.

Capacidades principais

Registro por plugin

Registre o endpoint do webhook com app.register(...) e opcoes do proprio adapter.

Verificacao de assinatura

Rejeite requests invalidas antes que os handlers da aplicacao rodem.

Hooks de evento tipados

Trate eventos nomeados da Rewrite diretamente ou use onPayload para dispatch generico.

Suporte a parser

O adapter pode registrar o parser JSON necessario para tratar webhooks verificados.

Instalacao

Exemplo basico

Boas praticas

Deixe o adapter ser o dono da rota da Rewrite para que parsing e verificacao de assinatura continuem previsiveis.
Retorne sucesso cedo e entregue o trabalho lento para filas ou workers em background, reduzindo retries.
Persista o id do evento e proteja escritas downstream contra entregas repetidas durante retries.
O adapter suporta onSMSOTP, onMessageSent, onMessageBatch, onMessageQueued, onMessageDelivered, onMessageScheduled, onMessageFailed, onMessageCanceled e o hook generico onPayload.

Documentacao relacionada

Visao geral de Adapters

Compare os adapters oficiais e entenda quando eles fazem mais sentido que os pacotes base.

Visao geral de Webhooks

Semantica de entrega, retries e detalhes da verificacao de assinatura.

Tipos de evento

Familias de evento e referencias de payload dos webhooks suportados pela Rewrite.