Em aplicações mais robustas, onde uma tabela pode ter milhões de registros, é importante implementar a paginação em uma API REST. Já vi em alguns projetos duas formas de devolver as informações de paginação (número da página, tamanho da página, ordenação, etc)
No corpo da resposta
- As informações de paginação ficam no corpo, tais como totalPages, totalElements, size, number, etc;
- A lista de elementos é empacotada em um array
content
, sendo parte do objeto página retornado;
No header da resposta
- As informações de paginação ficam header, tais como totalPages, totalElements, size, number, etc;
- A lista de elementos é o array principal retornado;
Levando em conta o design de uma API REST, qual a forma correta de passar os dados de paginação no response?