Fatos principais
- Categoria
- Network
- Tipos de entrada
- text, checkbox, select, number
- Tipo de saída
- html
- Cobertura de amostras
- 4
- API disponível
- Yes
Visão geral
O Depurador e Relay de Webhook é uma ferramenta essencial para desenvolvedores que precisam inspecionar, validar e reencaminhar requisições HTTP em tempo real. Ao gerar uma URL única de captura, você pode receber payloads de serviços externos, verificar assinaturas de segurança (HMAC) e configurar o reenvio automático ou manual para o seu ambiente de desenvolvimento local ou servidor de produção.
Quando usar
- •Quando você precisa testar integrações de APIs de terceiros (como Stripe ou GitHub) antes de enviar os dados para o servidor de produção.
- •Para depurar payloads de webhooks que estão falhando devido a assinaturas inválidas ou formatos de corpo de requisição incorretos.
- •Quando é necessário criar um túnel temporário para inspecionar requisições e reencaminhar apenas os eventos que atendem a critérios específicos.
Como funciona
- •A ferramenta gera uma URL de captura exclusiva para você configurar no painel do serviço de terceiros.
- •As requisições recebidas são inspecionadas em tempo real, validando cabeçalhos de assinatura e filtrando métodos HTTP ou conteúdos específicos do corpo.
- •Os payloads capturados são armazenados temporariamente no painel, permitindo a visualização detalhada de cabeçalhos e dados.
- •Você pode configurar uma URL de destino para reenviar (relay) as requisições manualmente ou ativar o reenvio automático para eventos compatíveis.
Casos de uso
Exemplos
1. Capturar e depurar webhooks do Stripe
Desenvolvedor Backend- Contexto
- A equipe está implementando um novo sistema de faturamento e precisa garantir que os eventos de pagamento do Stripe estão sendo processados corretamente.
- Problema
- É difícil testar webhooks localmente e verificar se a assinatura do Stripe está sendo validada da forma certa antes de ir para produção.
- Como usar
- Gere a URL de captura, defina o cabeçalho como 'stripe-signature', insira o segredo de teste e configure o filtro para conter '"type":"invoice.paid"'.
- Configuração de exemplo
-
{ "relayTargetUrl": "https://api.empresa.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"" } - Resultado
- Apenas os eventos de faturas pagas são validados e reencaminhados para a API de destino, permitindo uma depuração segura e focada.
2. Relay condicional de payloads do GitHub
Engenheiro de DevOps- Contexto
- O servidor de integração contínua precisa receber notificações do GitHub apenas quando há um push na branch principal (main).
- Problema
- O GitHub envia webhooks para várias ações, sobrecarregando o servidor de CI com eventos irrelevantes.
- Como usar
- Configure a URL de destino do servidor CI, ative o reenvio automático e defina a regra para que o corpo contenha a referência da branch main.
- Configuração de exemplo
-
{ "relayTargetUrl": "https://ci.empresa.com/github-webhook", "signatureSecret": "github_secret_value", "signatureHeader": "x-hub-signature-256", "autoReplay": true, "bodyMustContain": "\"ref\":\"refs/heads/main\"" } - Resultado
- O painel captura todos os eventos para auditoria, mas apenas os pushes na branch 'main' são reencaminhados automaticamente para o servidor de CI.
Testar com amostras
networkHubs relacionados
FAQ
Posso validar assinaturas de webhooks com esta ferramenta?
Sim, você pode fornecer o segredo de assinatura e o nome do cabeçalho (como 'stripe-signature') para que a ferramenta valide automaticamente a autenticidade do payload.
Quantas requisições posso armazenar no histórico?
Você pode configurar o limite de armazenamento entre 10 e 200 requisições simultâneas no painel.
É possível filtrar quais eventos serão reencaminhados?
Sim, você pode usar o filtro de método HTTP (como apenas POST) e definir uma string específica que o corpo da requisição deve conter para acionar o relay.
O reenvio (relay) acontece automaticamente?
Depende da sua configuração. Você pode ativar a opção de reenvio automático para requisições compatíveis ou fazer o replay manualmente a partir do histórico.
Quais métodos HTTP são suportados para captura?
A ferramenta pode capturar qualquer método, ou você pode restringir a captura apenas para requisições POST, PUT ou PATCH através do filtro de método.