Referência de API
Endpoints públicos
Consulte os endpoints disponíveis para integrar dados automotivos ao seu sistema usando API Key, API Secret e respostas JSON.
Base URL atual
https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1Catálogo
2 endpoints nesta categoria.
Rota
/catalog/vehiclesRetorna lista paginada de veículos do catálogo com filtros opcionais, incluindo ano exato via `ano` ou intervalo via `ano_min`/`ano_max`.
Rota
/catalog/vehicles/{vehicle_id}Retorna objeto com `vehicle_id`, `veiculo`, `consumo` e `emissoes`.
Rankings
9 endpoints nesta categoria.
Rota
/rankings/overviewLista consolidada com ranking_tipo e métricas por veículo.
Rota
/rankings/most-economicalTop 10 por eficiência média de referência.
Rota
/rankings/lowest-co2Top 10 por menor `co2_referencia_g_km`.
Rota
/rankings/electric-rangeTop 10 de veículos elétricos por `autonomia_km`.
Rota
/rankings/customRanking customizado por `metric`, `order`, `top` e filtros.
Rota
/rankings/by-categoryAgrupa ranking por categoria.
Rota
/rankings/by-brandAgrupa ranking por marca.
Rota
/rankings/by-fuelAgrupa ranking por combustível.
Rota
/rankings/by-yearAgrupa ranking por ano.
Comparação
3 endpoints nesta categoria.
Rota
/compareCompara veículos e retorna vencedores por critério e vencedor geral.
Rota
/vehicles/{vehicle_id}/compare-similarRetorna itens similares ao veículo base.
Rota
/vehicles/{vehicle_id}/best-alternativeRetorna o melhor candidato alternativo para o veículo informado.
Insights de Veículos
7 endpoints nesta categoria.
Rota
/vehicles/{vehicle_id}/summaryRetorna resumo com blocos `veiculo`, `consumo` e `emissoes`.
Rota
/vehicles/{vehicle_id}/eco-scoreRetorna eco score, faixa e metadados de origem.
Rota
/vehicles/{vehicle_id}/ranking-positionsRetorna posição global/categoria/combustível e percentil.
Rota
/insights/eco-scoresRetorna eco scores com paginação e filtros.
Rota
/insights/efficiencyRetorna eficiência e consumo com paginação e filtros.
Rota
/insights/emissionsRetorna médias por categoria/combustível e distribuição por faixa.
Rota
/insights/summaryRetorna médias gerais, melhores/piores categorias e distribuição de eco score.
Agregações
6 endpoints nesta categoria.
Rota
/aggregations/by-brandAgrupa indicadores por marca.
Rota
/aggregations/by-yearAgrupa indicadores por ano.
Rota
/aggregations/by-fuelAgrupa indicadores por combustível.
Rota
/aggregations/by-categoryAgrupa indicadores por categoria.
Rota
/aggregations/efficiency-distributionDistribuição por faixas de eficiência.
Rota
/aggregations/emissions-distributionDistribuição por faixas de emissões.