Paginação e filtros

Listagens usam os parâmetros de query abaixo quando suportados pela rota:

Parâmetro	Padrão	Limite
page	1	inteiro positivo
per_page	20	inteiro positivo até 100
search	—	busca textual da rota
sort	—	campo de ordenação permitido pela rota
order	asc	asc ou desc
filters	—	filtro estruturado quando a rota o documenta

Exemplo:

curl 'https://api.meusclubes.com/api/v1/clubs/club_demo_001/members?page=1&per_page=25&sort=name&order=asc' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'X-Club-Id: club_demo_001'

O servidor pode limitar ou rejeitar campos de ordenação que não façam parte do contrato da rota. Use o OpenAPI para consultar os parâmetros específicos de cada endpoint.