IDs de marcas renumerados e nova ordenação de preços
IDs de marcas renumerados
Os IDs de /api/v1/marcas agora são sequenciais em ordem alfabética, por tipo de veículo: carros de 1 a 108, motos de 109 a 213 e caminhões de 214 a 242. Antes, marcas adicionadas ao longo do tempo recebiam IDs fora de ordem (ex.: Aston Martin = 84 aparecia entre Asia Motors = 5 e Audi = 6).
| Marca | ID antigo | ID novo |
|---|---|---|
| Acura | 1 | 1 |
| Aston Martin | 84 | 6 |
| BYD | 93 | 13 |
| VW - Volkswagen | 58 | 105 |
Se a sua integração armazena IDs de marca (em banco, cache ou configuração), refaça a consulta a /api/v1/marcas e re-resolva os IDs pelo nome da marca. Se você sempre consulta /marcas antes de navegar para modelos e preços, nenhuma ação é necessária. Os IDs de modelos, anos e preços não mudaram.
Nova ordenação nos endpoints de preços
As respostas de /marcas/{id}/precos e /modelos/{id}/precos agora vêm ordenadas por:
- mês de referência, do mais recente para o mais antigo (como antes);
- dentro do mês, ano do modelo decrescente — 0 km primeiro, depois 2026, 2025, e assim por diante.
Antes, a ordem dentro do mês não tinha significado. Se você já reordenava os resultados no seu lado, nada muda.
Cursores de paginação
O formato interno do cursor de paginação mudou para acompanhar a nova ordenação. Cursores são opacos e os antigos continuam aceitos, mas se você guarda cursores de longa duração, recomendamos descartá-los e reiniciar a paginação da primeira página.
Erros 500 intermitentes e desempenho
Corrigimos um problema que fazia consultas de histórico completo em /marcas/{id}/precos e /modelos/{id}/precos (planos pagos) retornarem erro 500 intermitente em marcas e modelos com muito histórico. Além da correção, essas consultas ficaram significativamente mais rápidas — o pior caso caiu de ~7 segundos para menos de 200 ms.
A documentação e a collection do Postman foram atualizadas com os novos exemplos.
