Política de reintento
Consideramos una entrega exitosa si tu endpoint responde con 2xx en menos de 10 segundos. Cualquier otro resultado (timeout, 4xx, 5xx, error de DNS, TLS inválido) marca la entrega como fallida y la programamos para reintento.
Los reintentos siguen backoff exponencial durante 24 horas:
| Intento | Espera desde el anterior |
|---|---|
| 1 | - |
| 2 | 30 s |
| 3 | 2 min |
| 4 | 10 min |
| 5 | 30 min |
| 6 | 1 h |
| 7 | 2 h |
| 8 | 4 h |
| 9 | 8 h |
| 10 | 9 h |
Pasadas 24 horas sin éxito, descartamos el evento y marcamos la suscripción como degradada en el panel. Si una suscripción acumula muchos fallos consecutivos, la desactivamos automáticamente y te notificamos por email.
Inspección de entregas
Puedes ver el historial de entregas desde la API:
curl "https://api.lectico.com/v1/webhooks/whs_01HZ.../deliveries?limit=50" \
-H "Authorization: Bearer $LECTICO_API_KEY"Cada entrega incluye: id, event_id, status (succeeded, failed, pending), response_status, attempt_count, last_attempted_at.
También lo ves en app.lectico.com en la sección Webhooks, con el body y la respuesta completa para debug.
Disparar una entrega de prueba
Para validar que tu endpoint responde correctamente sin esperar a un evento real:
curl -X POST "https://api.lectico.com/v1/webhooks/whs_01HZ.../test" \
-H "Authorization: Bearer $LECTICO_API_KEY"Lectico programa una entrega con type: "webhook.test" y payload mínimo. La respuesta incluye el delivery_id que puedes consultar en /v1/webhooks/{id}/deliveries.
Pausar temporalmente
Para dejar de recibir eventos sin perder la configuración:
curl -X PATCH "https://api.lectico.com/v1/webhooks/whs_01HZ..." \
-H "Authorization: Bearer $LECTICO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"is_active": false}'Mientras is_active: false, no se programan entregas nuevas. Los eventos generados durante ese tiempo no se guardan: al reactivar solo recibirás eventos futuros.