L'alternative à ngrok pour les webhooks
ngrok est un excellent tunnel généraliste, mais pour debugger des webhooks il est cher et ne capture rien. Le Relay de Webhook Toolkit est un tunnel dédié aux webhooks : URL permanente, CLI sans installation. À côté, le Receiver garde l'historique de tes requêtes et sait les rejouer vers ton handler.
curl -fsSL https://webhook-toolkit.com/relay.js -o relay.js node relay.js --token=rly_xxx --to=localhost:3000
Questions fréquentes
Le Relay remplace-t-il ngrok ?
Pour les webhooks, oui. Le Relay te donne une URL publique permanente qui forwarde chaque requête vers ton localhost. Pour exposer un site web généraliste, ngrok reste plus adapté ; pour debugger des webhooks Stripe/GitHub/Shopify, le Relay est plus simple, et le Receiver garde l'historique à côté.
Faut-il installer quelque chose ?
Non. La CLI du Relay est un fichier unique sans dépendance qui utilise le WebSocket natif de Node 21+. Tu la télécharges et la lances : node relay.js --token=… --to=localhost:3000.
L'URL change-t-elle à chaque redémarrage ?
Non, contrairement aux URL ngrok gratuites. Ton URL de Relay est permanente, tu peux la laisser configurée dans ton API tierce.
Puis-je rejouer une requête ?
Oui, sur les requêtes capturées par le Receiver : ouvre l'inspecteur, choisis la requête, colle l'URL de ton handler et clique sur Rejouer. On renvoie la méthode, les headers et le body d'origine — signature comprise — puis on affiche le code de retour et la réponse. Le Relay, lui, forwarde en direct sans rien stocker : si tu veux pouvoir rejouer, mets aussi une URL de capture /r/<token> en face.