Paginação

As operações de listagem do contrato público atual retornam coleções diretas. Planeje seu cliente para evoluir com filtros, cursores ou página numérica sem quebrar contratos internos.

Recomendação

• Encapsule leitura de listas em adaptadores.
• Sempre trate resposta vazia como estado válido.
• Não presuma ordenação implícita sem explicitar isso na sua aplicação.

Quando um endpoint público ganhar paginação formal, a mudança aparecerá primeiro no changelog e depois no OpenAPI.