Webhooks

Live
Receba eventos terminais de Prediction assinados, com retentativas e logs de entrega.
Abrir no ChatGPT
(opens in new tab)Última verificação: 2026-08-11

Registre um endpoint

Chame POST /webhooks/endpoints com uma URL HTTPS pública. Salve o segredo de assinatura devolvido na hora: ele é exibido só uma vez. A consulta por GET /predictions/:id continua disponível e é o caminho de recuperação quando a entrega atrasa.

Verifique e deduplique

Leia o corpo bruto, interprete x-modelrush-signature como t=TIMESTAMP,v1=HMAC, rejeite timestamps vencidos e compare o HMAC-SHA256 em tempo constante. Deduplique por x-modelrush-event-id; os handlers precisam ser idempotentes porque a entrega é pelo menos uma vez.

Retentativas e logs

O ModelRush usa tempo limite de 10 segundos e backoff exponencial por até oito tentativas, e depois marca a entrega como dead-letter. Consulte os logs em GET /webhooks/deliveries; repita eventos falhos ou em dead-letter com POST /webhooks/deliveries/:id/retry. Uma retentativa manual nunca executa a tarefa do modelo de novo.
AnteriorEnviar mídia
PróximaErros, retentativas e limites