- Gratuito
- Nessuna registrazione
- Scade in 24h
Tester Webhook / Callback
Ottieni un URL temporaneo, punta un callback verso di esso e ispeziona i corpi ricevuti e le intestazioni conservate. Progettato per il debug dei callback di attività asincrone HiAPI. I corpi POST superiori a 64 KiB restituiscono 413 e non vengono mai archiviati né troncati; cookie, intestazioni IP inoltrato/client e segreto di ingresso non vengono conservati.
Chiunque possieda questo URL può leggere ciò che arriva qui, e tutto viene eliminato alla scadenza. Non usarlo per traffico di produzione o dati sensibili.
Invia un payload di esempio al tuo indirizzo da questo browser, così puoi vedere lo strumento in funzione prima di configurare un callback reale.
Risposta che riceve il mittente
Modifica questo per testare i nuovi tentativi: restituisci uno stato non-2xx e HiAPI riproverà il callback, così puoi osservare la pianificazione nella lista.
Richieste
In attesa della prima richiesta…
Punta il tuo callback sull'URL qui sopra, o invia una richiesta di test per vedere come appare.
Dettaglio richiesta
Seleziona una richiesta per vedere le sue intestazioni e il corpo.
Crea un'attività con questo callback
Copia questo, sostituisci la chiave e il modello, ed eseguilo.
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"callback": { "url": "https://www.hiapi.ai/tools/webhook-tester/hook/YOUR_TOKEN", "when": "final" },
"input": { "prompt": "a cyan glass data center entrance", "duration": 5, "resolution": "720p" }
}'How to test a webhook in three steps
Copia il tuo URL temporaneo
Apri questa pagina e copia l'indirizzo che ti dà. Rimane attivo per 24 ore e accetta POST da qualsiasi origine.
Punta il tuo callback verso di esso
Passalo come callback.url quando crei un'attività asincrona, oppure usa il pulsante «Invia richiesta di test» per inviarne una immediatamente.
Leggi la richiesta
Le richieste appaiono man mano che arrivano. Ispeziona intestazioni, corpo e tipo di contenuto; incolla la tua chiave di firma webhook per verificare la firma localmente.
What this tool cannot do
- Confronta solo la coerenza HMAC di HiAPI, non la freschezza o la protezione contro il replay, e una corrispondenza da sola non può provare l'origine. Senza una chiave di firma, un callback appare come qualsiasi altro POST.
- I corpi superiori a 64 KiB restituiscono 413 e non vengono mai archiviati né troncati. Cookie, intestazioni IP inoltrato/client e segreto di ingresso non vengono conservati.
- Il replay non è una richiesta originale esatta. Le intestazioni vengono rimosse e le regole CORS, di contenuto misto o di rete locale possono bloccarlo; l'accesso a localhost non è garantito.
- Non può cercare attività. Riceve solo payload, quindi non ha accesso allo stato delle attività, al saldo o agli artefatti.
- Non è un archivio permanente. L'indirizzo e il suo contenuto vengono distrutti dopo 24 ore, quindi non inviare dati di produzione o sensibili.
- L'URL è una credenziale. Chiunque lo possieda può leggere ciò che arriva.
- Un target localhost non riceve mai un vero callback HiAPI, perché HiAPI deve raggiungerlo attraverso internet pubblico.
Webhook tester FAQ
A cosa serve un tester webhook?
Un tester webhook ti dà un indirizzo che accetta richieste HTTP in arrivo e mostra le intestazioni conservate e il corpo. Cookie, intestazioni IP inoltrato/client e segreto di ingresso vengono scartati. I corpi superiori a 64 KiB restituiscono 413 e non vengono mai archiviati né troncati. Ti evita di dover configurare un server solo per ispezionare un callback.
Come testo un callback HiAPI?
Crea un'attività sull'API HiAPI e passa l'URL di questa pagina come callback.url. Quando l'attività raggiunge uno stato terminale, HiAPI POSTa il risultato qui e la richiesta appare nella lista.
Perché il callback non arriva quando testo contro HiAPI in locale?
Un callback deve essere raggiungibile da internet pubblico. La tua macchina di solito non lo è, quindi un indirizzo localhost non riceverà mai un vero callback HiAPI. Usa un URL su un host pubblico — questa pagina te ne dà uno.
Posso verificare che un callback provenga davvero da HiAPI?
Con una chiave di firma webhook, questo strumento ricalcola HMAC-SHA256 sul corpo conservato e X-HiAPI-Timestamp e confronta X-HiAPI-Signature localmente. Una corrispondenza mostra coerenza con quella chiave, non freschezza o protezione contro il replay. Senza chiave di firma non c'è firma da confrontare.
La mia chiave di firma webhook viene inviata al vostro server?
No. La chiave viene usata solo nell'API crypto del tuo browser per ricalcolare la firma. Non viene mai trasmessa, archiviata né registrata, e la richiesta che raggiunge il nostro server non la contiene.
Quanto dura l'indirizzo e cosa succede ai dati?
L'indirizzo e tutto ciò che ha ricevuto vengono eliminati dopo 24 ore. Ogni indirizzo conserva fino a 50 richieste. Tratta l'URL come una credenziale: chiunque lo possieda può leggere ciò che è arrivato, quindi non usarlo per produzione o dati sensibili.
Può dirmi con quale frequenza HiAPI riprova un callback fallito?
Sì, ed è per questo che lo stato della risposta è configurabile. Imposta la risposta a 400 o 500, attiva un'attività reale e gli orari di arrivo nella lista ti mostrano il programma di nuovi tentativi. I nuovi tentativi avvengono immediatamente, poi a +1, +5 e +20 minuti, quattro tentativi in totale.
Posso riprodurre una richiesta?
Il replay effettua una richiesta al meglio dal tuo browser, non una copia esatta. Cookie, autorizzazione, intestazioni proxy/piattaforma e controllate dal browser non vengono inoltrati, e i reindirizzamenti vengono rifiutati. Il target deve consentire CORS; il contenuto misto HTTPS verso HTTP e le regole di rete locale del browser possono bloccarlo. Localhost può funzionare ma non è garantito. Una risposta bloccata non prova che il target non abbia ricevuto nulla.