Plataforma
Webhook
Un webhook es una llamada HTTP firmada que una plataforma envía a tu servidor cuando termina una tarea asíncrona, para que no tengas que consultarla una y otra vez. La generación de video, que tarda minutos, es el caso típico.
Las firmas permiten al receptor verificar que el payload viene de la plataforma.
En eroq
Eventos video.generation.succeeded / failed con un encabezado eroq-signature al estilo de Stripe, que se configuran en el panel de desarrolladores.
Preguntas
¿Tengo que usar webhooks?
No: consultar periódicamente GET /v1/videos/generations/{id} también funciona.
¿Qué eventos envía eroq?
video.generation.succeeded y video.generation.failed, además de un evento de prueba que lanzas tú desde el panel. Las imágenes, la voz y el chat responden en la propia solicitud, así que no hay nada que notificar después.
¿Cómo verifico un webhook de eroq?
Vuelve a calcular la firma. El encabezado eroq-signature contiene una marca de tiempo y un digest hexadecimal: el HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar, con el secreto del endpoint como clave, que se muestra una sola vez al crearlo.
Más términos de plataforma