Sudrel API
Panel Crear clave de API

Documentación › Notificaciones

Guías

Eventos

El log de eventos de la cuenta, por cursor, con 90 días de retención.

El registro de eventos de la cuenta: todo evento, con o sin webhook, en orden. Léelo con GET /v1/eventos?apos=<cursor> y guarda el proximo_cursor de cada respuesta (viene incluso cuando la página está vacía). Los eventos vienen en orden, y el cursor solo avanza; nunca uses fechas para paginar.

El cursor es un texto opaco: guárdalo y devuélvelo exactamente como vino, sin interpretarlo. El seq de cada evento es el mismo tipo de cursor. Hasta el 02/10/2026 era un número; un cursor numérico guardado antes de esa fecha sigue siendo aceptado en apos.

Sin apos, la lectura empieza en el evento más antiguo todavía guardado. Filtra por tipo con tipos (separados por coma). Cada evento trae id (el mismo X-Sudrel-Event-Id del webhook), tipo, ocorrido_em, ambiente, empresa_id, recurso (tipo, id y url para leer el estado actual) y dados.

dados viene completo cuando el cuerpo se guardó (había un webhook suscrito al tipo, y siempre en los documentos recibidos); si no, es null y recurso.url indica dónde leer el estado actual.

Retención: 90 días. Un cursor más antiguo que eso responde 410 cursor_vencido, con cursor_mais_antigo: continúa a partir de él y verifica por las rutas de lectura lo que pudo haber cambiado en el intervalo.

Rutas de esta sección, con prueba en la página