Paginação - Routa

Os endpoints de lista usam paginação por cursor (keyset). Não existe paginação por page e offset: em tabelas que só crescem, isso ficaria mais lento e inconsistente a cada página.

Parâmetros

Parâmetro	Descrição
`limit`	Itens por página, de 1 a 100. O padrão é 20.
`cursor`	Valor de `next_cursor` da página anterior.
`after`	Somente em `GET /v1/events`: o `id` do último evento processado.

Formato da resposta

{
  "data": [
    { "id": "msg_01J8...", "status": "delivered" }
  ],
  "has_more": true,
  "next_cursor": "eyJ..."
}

Campo	Descrição
`data`	Itens da página.
`has_more`	`true` se existem mais páginas.
`next_cursor`	Cursor da próxima página, ou `null` na última.

Trate o next_cursor como um valor opaco: não o decodifique nem o construa. Um cursor inválido retorna 422 invalid_cursor.

Em GET /v1/events o cursor é o próprio id do evento, passado em after. Veja Reconciliar eventos.

Percorrendo todas as páginas

# Primeira página
curl "https://api.routa.chat/v1/messages?limit=50" \
  -H "Authorization: Bearer $ROUTA_API_KEY"

# Próxima página
curl "https://api.routa.chat/v1/messages?limit=50&cursor=eyJ..." \
  -H "Authorization: Bearer $ROUTA_API_KEY"

// O iterador assíncrono busca as páginas seguintes para você.
for await (const message of routa.messages.list({ direction: 'inbound', limit: 50 })) {
  console.log(message.id, message.from, message.content)
}

// Para controlar a paginação manualmente, peça uma página por vez:
const page = await routa.messages.list({ limit: 20 }).page()
console.log(page.data.length, page.hasMore, page.nextCursor)

Endpoints paginados

Endpoint	Filtros
`GET /v1/messages`	`direction`
`GET /v1/events`	`type`, `after`
`GET /v1/templates`	`channel`
`GET /v1/webhook_endpoints/{id}/deliveries`	`state`

GET /v1/webhook_endpoints também usa o envelope { data, has_more, next_cursor }, mas retorna todos os endpoints de uma vez (no máximo 5 por projeto).