- Gratis
- Sin registro
- Caduca en 24h
Probador de Webhook / Callback
Obtén una URL temporal, apunta un callback hacia ella e inspecciona los cuerpos recibidos y cabeceras retenidas. Diseñado para depurar callbacks de tareas asíncronas de HiAPI. Los cuerpos POST de más de 64 KiB devuelven 413 y nunca se almacenan ni se truncan; las cookies, cabeceras de IP reenviada/cliente y secretos de ingreso no se retienen.
Cualquiera que tenga esta URL puede leer lo que llega aquí, y todo se elimina cuando caduca. No la uses para tráfico de producción ni datos sensibles.
Publica una carga de ejemplo en tu dirección desde este navegador, para que puedas ver la herramienta funcionar antes de conectar un callback real.
Respuesta que recibe el remitente
Cambia esto para probar reintentos: devuelve un estado no 2xx y HiAPI reintentará el callback, para que puedas ver el calendario en la lista.
Solicitudes
Esperando la primera solicitud…
Apunta tu callback a la URL de arriba, o envía una solicitud de prueba para ver cómo se ve.
Detalle de solicitud
Selecciona una solicitud para ver sus cabeceras y cuerpo.
Crear una tarea con este callback
Copia esto, reemplaza la clave y el modelo, y ejecútalo.
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 tu URL temporal
Abre esta página y copia la dirección que te da. Permanece activa durante 24 horas y acepta POST de cualquier origen.
Apunta tu callback hacia ella
Pásala como callback.url al crear una tarea asíncrona, o usa el botón de enviar solicitud de prueba para lanzar una de inmediato.
Lee la solicitud
Las solicitudes aparecen a medida que llegan. Inspecciona cabeceras, cuerpo y tipo de contenido; pega tu clave de firma de webhook para verificar la firma localmente.
What this tool cannot do
- Solo compara la consistencia HMAC de HiAPI, no la frescura ni la protección contra reproducción, y una coincidencia por sí sola no prueba el origen. Sin una clave de firma, un callback se ve como cualquier otro POST.
- Los cuerpos de más de 64 KiB devuelven 413 y nunca se almacenan ni se truncan. Las cookies, cabeceras de IP reenviada/cliente y secretos de ingreso no se retienen.
- La reproducción no es una solicitud original exacta. Las cabeceras se eliminan y las reglas CORS, de contenido mixto o de red local pueden bloquearla; el acceso a localhost no está garantizado.
- No puede consultar tareas. Solo recibe cargas útiles, por lo que no tiene acceso al estado de la tarea, saldo ni artefactos.
- No es almacenamiento permanente. La dirección y su contenido se destruyen después de 24 horas, así que no envíes datos de producción ni sensibles.
- La URL es una credencial. Cualquiera que la tenga puede leer lo que llega.
- Un destino localhost nunca recibe un callback real de HiAPI, porque HiAPI debe alcanzarlo a través de internet público.
Webhook tester FAQ
¿Para qué sirve un probador de webhooks?
Un probador de webhooks te da una dirección que acepta solicitudes HTTP entrantes y muestra las cabeceras retenidas y el cuerpo. Las cookies, cabeceras de IP reenviada/cliente y secretos de ingreso se descartan. Los cuerpos de más de 64 KiB devuelven 413 y nunca se almacenan ni se truncan. Te ahorra tener que levantar un servidor solo para inspeccionar un callback.
¿Cómo pruebo un callback de HiAPI?
Crea una tarea en la API de HiAPI y pasa la URL de esta página como callback.url. Cuando la tarea alcanza un estado terminal, HiAPI hace POST del resultado aquí y la solicitud aparece en la lista.
¿Por qué no llega el callback cuando pruebo contra HiAPI localmente?
Un callback debe ser accesible desde internet público. Tu propia máquina generalmente no lo es, por lo que una dirección localhost nunca recibirá un callback real de HiAPI. Usa una URL en un host público; esta página te da una.
¿Puedo verificar que un callback realmente vino de HiAPI?
Con una clave de firma de webhook, esta herramienta recalcula HMAC-SHA256 sobre el cuerpo retenido y X-HiAPI-Timestamp y compara X-HiAPI-Signature localmente. Una coincidencia muestra consistencia con esa clave, no frescura ni protección contra reproducción. Sin clave de firma no hay firma que comparar.
¿Mi clave de firma de webhook se envía a su servidor?
No. La clave solo se usa en la API criptográfica de tu navegador para recalcular la firma. Nunca se transmite, almacena ni registra, y la solicitud que llega a nuestro servidor no la contiene.
¿Cuánto dura la dirección y qué pasa con los datos?
La dirección y todo lo que recibió se eliminan después de 24 horas. Cada dirección conserva hasta 50 solicitudes. Trata la URL como una credencial: cualquiera que la tenga puede leer lo que llegó, así que no la uses para producción ni datos sensibles.
¿Puede decirme con qué frecuencia HiAPI reintenta un callback fallido?
Sí, y esa es la razón por la que el estado de respuesta es configurable. Configura la respuesta a 400 o 500, dispara una tarea real y los tiempos de llegada en la lista te muestran el calendario de reintentos. Los reintentos se disparan inmediatamente, luego a +1, +5 y +20 minutos, cuatro intentos en total.
¿Puedo reproducir una solicitud?
La reproducción hace una solicitud de mejor esfuerzo desde tu navegador, no una copia exacta. Las cookies, autorización, cabeceras de proxy/plataforma y controladas por el navegador no se reenvían, y las redirecciones se rechazan. El destino debe permitir CORS; el contenido mixto HTTPS a HTTP y las reglas de red local del navegador pueden bloquearlo. Localhost puede funcionar pero no está garantizado. Una respuesta bloqueada no prueba que el destino no haya recibido nada.