Haz pull de los eventos a los que tienes derecho
Obtiene una página de los eventos a los que una suscripción pull tiene derecho, en orden de llegada seq. La lectura funciona también como el acknowledgment (cursor-as-ack): tras una obtención exitosa, el seq más alto devuelto se persiste como el cursor de la suscripción, de forma monotónica. Un cursor after explícito sobrescribe el cursor persistido para la lectura; un salto hacia adelante avanza el cursor durable más allá del hueco no leído (el rango omitido no se vuelve a entregar — caller-owns-the-gap), mientras que un salto hacia atrás nunca lo rebobina. La lectura tiene rate limit por tenant. Los eventos son at-least-once; deduplica en ceId.
Autorizaciones
Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva contexto de tenant.
Parámetros de consulta
The pull subscription to read. Resolved through an existence gate then a kind gate: an absent, cross-tenant, or non-pull id all return a uniform 404 not_found (no existence or kind oracle).
Explicit keyset cursor (replay). When present it overrides the persisted cursor for the read; absent it, the read resumes from the persisted acknowledged seq (0 = from the beginning). A malformed value is ignored and folds to the persisted cursor.
Page size, clamped to the range 1–500, defaulting to 100.
Respuesta
Una página de eventos en orden ascendente de seq.
A page of events in ascending seq order.
The maximum seq in the page when it filled exactly to limit (a possible next page); null on a short or final page. This diverges deliberately from the subscriptions list cursor (which is a DESC-by-id string with an empty-string sentinel).
42

