Webhooks

Live
Recibe eventos de Prediction terminales firmados, con reintentos y registros de entrega.
Abrir en ChatGPT
(opens in new tab)Última verificación: 2026-08-11

Registra un endpoint

Llama a POST /webhooks/endpoints con una URL HTTPS pública. Guarda el secreto de firma devuelto en ese momento: solo se muestra una vez. La consulta mediante GET /predictions/:id sigue disponible y es la vía de recuperación cuando la entrega se retrasa.

Verifica y deduplica

Lee el cuerpo en bruto, interpreta x-modelrush-signature como t=TIMESTAMP,v1=HMAC, rechaza marcas de tiempo caducadas y compara el HMAC-SHA256 en tiempo constante. Deduplica por x-modelrush-event-id; los manejadores deben ser idempotentes porque la entrega es al menos una vez.

Reintentos y registros

ModelRush usa un tiempo de espera de 10 segundos y retroceso exponencial durante un máximo de ocho intentos, y después marca la entrega como dead-letter. Consulta los registros en GET /webhooks/deliveries; reintenta los eventos fallidos o en dead-letter con POST /webhooks/deliveries/:id/retry. Un reintento manual nunca vuelve a ejecutar la tarea del modelo.
AnteriorSubir medios
SiguienteErrores, reintentos y límites