API FIPE

Changelog

Novos recursos, melhorias e correções da API FIPE. Mudanças marcadas como Breaking alteram o contrato público e podem exigir ação da sua parte.

IDs de marcas renumerados e nova ordenação de preços

Breaking

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).

MarcaID antigoID novo
Acura11
Aston Martin846
BYD9313
VW - Volkswagen58105

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.

Melhoria

Nova ordenação nos endpoints de preços

As respostas de /marcas/{id}/precos e /modelos/{id}/precos agora vêm ordenadas por:

  1. mês de referência, do mais recente para o mais antigo (como antes);
  2. 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.

Melhoria

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.

Correção

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.