Skip to Content
Urlizo API Docs
Pagination

Pagination

O formato real diverge do antigo API.md: a paginação vive dentro de data (não em pagination separado). Não há cursor em nenhum endpoint.

Padrão page/pageSize

Links, Domains, Webhooks, API Keys: page (default 1) e pageSize (default 20, max 100). Resposta: { data, total, page, pageSize, totalPages } com totalPages = ceil(total / pageSize).

GET /links?page=1&pageSize=20&search=promo&isActive=true

Analytics usa page/limit

Endpoints de Analytics: page (default 1) e limit (default 50, max 100). A resposta espelha limit como pageSize.

GET /api/v1/analytics/:linkId?page=1&limit=50

Exceções de envelope

  • GET …/deliveries usa a chave deliveries (não data).
  • GET /billing/plans{ plans[] } (sem paginação); invoices{ invoices[] } (limit 24 fixo no controller).
  • Summaries e subscription retornam objeto direto (ou null = Free implícito).