Versionamento

Como a API evolui.

A versão fica no caminho (/v1). Adicionar campos e rotas não é mudança incompatível, então ignore campos desconhecidos. Mudanças incompatíveis exigem uma nova versão.

O documento OpenAPI 3.1 está em /openapi.json na API. Um teste automatizado garante que cada rota documentada existe.