Documentación de Webhooks

Webhooks de la API
en tiempo real

Recibe notificaciones automáticas cuando tus videos estén listos, fallen o tus créditos estén bajos. Sin polling, sin esperas.

Firma HMAC-SHA256
5 reintentos automáticos
Entrega en <200ms

Cómo funcionan los webhooks

1

Envías la request

POST /api-generate con webhook_url en el body

2

Procesamos el video

Runway genera el video (2–4 min)

3

Te notificamos

POST a tu webhook_url con el payload firmado

4

Respondes 200

Tu servidor confirma la recepción

Configurar tu webhook

Incluye el parámetro webhook_url en cada request a /api-generate. También puedes configurar una URL global en tu API Dashboard para que se use en todas las requests.

POST /api-generate
{
  "image_url": "https://tu-cdn.com/producto.jpg",
  "prompt": "Slow cinematic push-in",
  "style": "cinematic",
  "package": "basic",
  "webhook_url": "https://tu-servidor.com/webhooks/dockora"
}

Política de reintentos

1er intentoInmediatoTu servidor no responde o devuelve 5xx
2do intento1 minutoReintento automático con backoff
3er intento5 minutosBackoff exponencial
4to intento30 minutosBackoff exponencial
5to intento2 horasÚltimo intento antes de marcar como fallido

Después de 5 intentos fallidos, recibirás un email de notificación y el webhook se marca como definitivamente fallido.

Requisitos del endpoint

  • Responder HTTP 200 en menos de 10 segundos
  • Aceptar POST con Content-Type: application/json
  • Ser accesible públicamente (no localhost)
  • Soportar HTTPS (HTTP no recomendado)

Causas de fallo

  • Timeout > 10 segundos sin respuesta
  • Respuesta HTTP 4xx o 5xx
  • Certificado SSL inválido o expirado
  • Endpoint no accesible (firewall, DNS)

Tienes dudas? Revisa las preguntas frecuentes o habla con nosotros

We use cookies

We use essential cookies to make our site work, and optional cookies for analytics and personalized ads (Google AdSense). · Cookie Policy