Pular para o conteúdo principal
GET
Puxar (pull) os eventos aos quais se tem direito

Autorizações

Authorization
string
header
obrigatório

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

subscription_id
string<uuid>
obrigatório

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).

after
integer<int64>

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.

limit
integer

Page size, clamped to the range 1–500, defaulting to 100.

Resposta

Uma página de eventos em ordem crescente de seq.

events
object[]
obrigatório

A page of events in ascending seq order.

next_cursor
integer<int64> | null
obrigatório

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).

Exemplo:

42