Quando você vai desenvolver uma integração com algum Gateway de pagamento é comum você precisar cadastrar um endpoint (URL) para que quando houver alguma mudança no status da transação o Gateway possa lhe enviar uma requisição notificando a alteração.
Essa abordagem é bastante interessante porque elimina a necessidade de você ter que ficar fazendo requisições na API do Gateway para verificar se houve alguma mudança no status da transação. Essa abordagem é popularmente conhecida como Postback ou Webhook.
Acima citei o Gateway de pagamento como exemplo, mas essa abordagem é amplamente utilizada e é bem fácil se deparar com ela no dia a dia, veja outros exemplos de integrações que utilizam Webhook:
Um grande problema desta abordagem é que mesmo em ambiente de desenvolvimento será necessário cadastrar um endpoint público para que você possa receber o Webhook e testar a sua integração.
Publicar um endpoint em produção somente para conseguir cadastrá-lo no Webhook, além de não ser uma boa prática, dá um puta trabalho, porque a cada correção que você fizer no seu endpoint você terá de repetir o processo de deploy.
E é aí que entra o RequestBin.
RequestBin
O RequestBin disponibiliza um endpoint para que você possa cadastrá-lo no serviço que irá lhe enviar os Webhooks e ainda lhe fornece uma dashboard para que você possa acompanhar em real time as requisições recebidas.
Para utilizar é bastante simples, acesse o site clique em Create RequestBin e faça login com o Google ou Github, ao logar você será redirecionado para a dashboard e o endpoint disponibilizado aparecerá em destaque, como na imagem abaixo:
Copie o endpoint e cadastre-o no serviço desejado, solicite o envio do webhook, assim que a requisição for enviada para o endpoint os dados dela aparecerão no painel do requestBin, como na imagem abaixo:
Pela dashboard é possível analisar com detalhes as requisições que chegaram via Webhook, é possível ver informações como:
- A Rota utilizada
- O Método HTTP
- Conteúdo do Header
- Conteúdo do Body
Com os dados da requisição em mãos, basta copiar os parâmetros da requisição e utilizar algum HTTP Client como o Postman para disparar a requisição para o seu endpoint local.
Utilizando o RequestBin como intermediador você consegue trabalhar localmente utilizando os dados reais de uma requisição feita via Webhook e elimina a necessidade de testar sua integração em produção.
Utilizo bastante esta ferramenta e como sempre esqueço o nome dela 😅, resolvi criar este post, assim facilita na próxima vez que eu precisar e ainda por cima compartilha com quem não a conhecia.
Quick Tips: Como o próprio nome sugere, a ideia dessa série é que sejam posts rápidos com dicas de ferramentas e outras coisas úteis que eu encontre por aí. =)