Puxar (pull) os eventos aos quais se tem direito
Busca uma página dos eventos aos quais uma assinatura pull tem direito, na ordem de chegada seq. A leitura também funciona como a confirmação (cursor-como-ack): após uma busca bem-sucedida, o maior seq retornado é persistido como o cursor da assinatura, de forma monotônica. Um cursor after explícito sobrepõe o cursor persistido para a leitura; um avanço para frente move o cursor durável para além do intervalo não lido (o trecho pulado não é reentregue — o chamador é dono da lacuna), enquanto um retrocesso nunca o rebobina. A leitura tem limite de taxa (rate limit) por tenant. Os eventos são at-least-once; deduplique por ceId.
Autorizações
Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega 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.
Resposta
Uma página de eventos em ordem crescente 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

