Paginação e filtros
Rascunho. O envelope de paginação do contrato de parceiro ainda não está decidido.
Veja o plano interno de organização, decisão D3.
Situação atual da api-v3
src/shared/infrastructure/pagination.ts:| Envelope | Campos | Origem |
|---|---|---|
buildPaginatedResponse | current_page, data, total, last_page, links, *_page_url | Cópia do paginador do Laravel |
buildSimplePaginatedResponse | igual, sem total e last_page | Cópia do simplePaginate |
withPagination | data, page, items | Convenção nova da v3 |
links com rótulo em HTML (« Previous) e umaentrada por página. Aquele campo existe para desenhar botão em tela, não para integração.
O que o contrato de parceiro vai adotar
{
"data": [],
"page": 1,
"per_page": 15,
"total": 128
}page, começando em 1. O tamanho de página padrão é 15.links, first_page_url, last_page_url, next_page_url,prev_page_url nem path. Aqueles campos vazam caminho interno e não servem a ninguém de fora.Modificado em 2026-09-01 16:38:38