¿Qué es un webhook?
Un webhook es una solicitud HTTP enviada por un sistema para notificar a otro que ocurrió un evento. Las implementaciones fiables verifican las firmas, toleran los reintentos y procesan las entregas duplicadas de forma idempotente.
Cómo funcionan los webhooks
Un productor de webhooks serializa un evento y lo envía a un endpoint HTTP controlado por el consumidor, lo que desvincula los cambios de estado asíncronos de las consultas periódicas. Normalmente, la entrega se realiza al menos una vez, en lugar de exactamente una vez, porque la pérdida de una respuesta impide que el emisor sepa si el procesamiento se completó correctamente. Por ello, el receptor autentica la solicitud original, registra la identidad del evento, confirma la recepción con rapidez y traslada el trabajo multimedia o de negocio que consume muchos recursos a una cola persistente.
Datos clave
- Los proveedores definen exactamente qué se firma: algunos firman los bytes sin procesar de la solicitud junto con una marca de tiempo, mientras que Transloadit envía una notificación
application/x-www-form-urlencodedcuyo camposignaturecontiene un HMAC-SHA1 hexadecimal en minúsculas de la cadena exacta del campotransloadit. Elige los secretos de verificación de una configuración confiable del lado del servidor para la Assembly y el Workspace esperados, porque un reenvío puede firmarse con una clave aplicable distinta; el contrato de verificación de webhooks contiene todas las reglas. Verifica el contenido que define el proveedor, nunca una versión serializada de nuevo. - Devolver una respuesta de éxito solo después de un procesamiento posterior prolongado aumenta los tiempos de espera agotados y los reintentos; guardar el evento de forma persistente antes de confirmar su recepción permite que el procesamiento continúe de forma asíncrona.
- Los reintentos pueden duplicar o cambiar el orden de los eventos, por lo que el identificador del evento y la versión actual del recurso son salvaguardas más seguras frente a los efectos secundarios que suponer que cada llamada al endpoint es única.
Cuándo son importantes los webhooks
Los webhooks pueden dar continuidad a la lógica de la aplicación cuando el procesamiento multimedia asíncrono finaliza o falla. Los consumidores deben autenticar las solicitudes y evitar repetir los efectos secundarios cuando el emisor reintenta un evento.