Paginação

Listas grandes vêm em páginas. Pedir todos os 609 carros vermelhos de uma vez seria demais.

/api/v1/vehicles?color=vermelho&page=2&limit=50

• page: qual página (começa em 1)
• limit: quantos por página (de 1 a 50, padrão 20)

A resposta diz onde você está:

{ "data": [ ... ], "page": 2, "limit": 50, "total": 609 }

E o header Link já traz os endereços prontos da primeira, anterior, próxima e última página. Veja com curl -i:

Link: </api/v1/vehicles?color=vermelho&page=1&limit=50>; rel="first", </api/v1/vehicles?color=vermelho&page=3&limit=50>; rel="next", ...

Dica de detetive: antes de paginar 13 páginas, tente combinar filtros pra encolher a lista.