L'alternativa a ngrok per i webhook
ngrok è un ottimo tunnel generico, ma per fare il debug dei webhook è costoso e non cattura nulla. Il Relay di Webhook Toolkit è un tunnel dedicato ai webhook: URL permanente, CLI senza installazione. Accanto, il Receiver conserva lo storico delle tue richieste e sa rieseguirle verso il tuo handler.
curl -fsSL https://webhook-toolkit.com/relay.js -o relay.js node relay.js --token=rly_xxx --to=localhost:3000
Domande frequenti
Il Relay sostituisce ngrok?
Per i webhook, sì. Il Relay ti dà un URL pubblico permanente che inoltra ogni richiesta verso il tuo localhost. Per esporre un sito web generico, ngrok resta più adatto; per fare il debug dei webhook Stripe/GitHub/Shopify, il Relay è più semplice, e il Receiver conserva lo storico accanto.
Bisogna installare qualcosa?
No. La CLI del Relay è un singolo file senza dipendenze che usa il WebSocket nativo di Node 21+. La scarichi e la avvii: node relay.js --token=… --to=localhost:3000.
L'URL cambia a ogni riavvio?
No, a differenza degli URL ngrok gratuiti. Il tuo URL Relay è permanente, puoi lasciarlo configurato nella tua API di terze parti.
Posso rieseguire una richiesta?
Sì, sulle richieste catturate dal Receiver: apri l'inspector, scegli la richiesta, incolla l'URL del tuo handler e premi Riesegui. Rinviamo metodo, header e body originali — firma compresa — poi mostriamo il codice di stato e la risposta. Il Relay inoltra in diretta senza salvare nulla: se vuoi poter rieseguire, mettici davanti anche un URL di cattura /r/<token>.