@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
Mantenha a rota de webhook isolada
Mantenha a rota de webhook isolada
Deixe o adapter ser o dono da rota da Rewrite para que parsing e verificacao de assinatura continuem previsiveis.
Confirme a entrega rapido e processe de forma assincrona
Confirme a entrega rapido e processe de forma assincrona
Retorne sucesso cedo e entregue o trabalho lento para filas ou workers em background, reduzindo retries.
Torne os handlers idempotentes
Torne os handlers idempotentes
Persista o id do evento e proteja escritas downstream contra entregas repetidas durante retries.
Callbacks de evento disponiveis
Callbacks de evento disponiveis
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.