Documentación › Notificaciones
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
- GET/v1/eventos · Log de eventos de la cuenta, por cursor