Método HTTP GET
Autenticação: API Key + API Secret
Catálogo
Obter payload completo de catálogo por veículo
Retorna objeto com `vehicle_id`, `veiculo`, `consumo` e `emissoes`.
Resumo técnico
- Método
- Método HTTP GET
- Rota
- /catalog/vehicles/{vehicle_id}
- URL completa
- https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1/catalog/vehicles/{vehicle_id}
Quando usar
Use em telas de detalhe que precisam da carga completa do veículo.
Headers obrigatórios
| Header | Obrigatório | Descrição | Exemplo |
|---|---|---|---|
| X-API-Key | Sim | Chave pública fornecida para consumo da API pública. | SUA_PUBLIC_KEY |
| X-API-Secret | Sim | Segredo pareado à API Key para autenticação. | SEU_SECRET |
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| vehicle_id | uuid | Sim | UUID do veículo. | - |
Campos principais da resposta
Retorna envelope com `data.data` contendo objetos aninhados vindos de `catalog.v_vehicle_summary`.
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| data.data.vehicle_id | string | Não | UUID do veículo. | - |
| data.data.veiculo | string | Não | Objeto JSON dinâmico. | - |
| data.data.consumo | string | Não | Objeto JSON dinâmico. | - |
| data.data.emissoes | string | Não | Objeto JSON dinâmico. | - |
Cenários de uso
- Integrar este endpoint em rotinas de consulta e enriquecimento de dados automotivos.
Exemplos de integração
Os exemplos desta documentação utilizam dados fictícios/mockados para fins ilustrativos, mas seguem a estrutura oficial real da API.
Nunca exponha X-API-Secret em aplicações front-end públicas. Para aplicações web públicas, faça a chamada a partir do seu backend.
Exemplo de integração (cURL)
curl -X GET "https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1/catalog/vehicles/87026fde-1886-43c2-bf6f-f5f89e1ddd9d" \
-H "X-API-Key: SUA_PUBLIC_KEY" \
-H "X-API-Secret: SEU_SECRET"Os exemplos desta documentação utilizam dados fictícios/mockados para fins ilustrativos, mas seguem a estrutura oficial real da API.
Exemplo de resposta
{
"success": true,
"data": {
"data": {
"vehicle_id": "002bba40-9cdb-4d61-adf0-46054e55c140",
"veiculo": {
"id": "002bba40-9cdb-4d61-adf0-46054e55c140",
"ano": 2026,
"marca": "AUDI",
"motor": "Elétrico",
"modelo": "Q6 e-tron Quattro",
"versao": "Performance",
"categoria": "Extra Grande",
"tipo_propulsao": "Elétrico",
"ar_condicionado": true,
"combustivel_tipo": "Elétrico",
"transmissao_tipo": "Automática",
"transmissao_marchas": 1,
"direcao_assistida_tipo": "Elétrica"
},
"consumo": {
"selo_conpet": null,
"autonomia_km": 411,
"consumo_cidade_etanol": null,
"consumo_estrada_etanol": null,
"consumo_cidade_gasolina": null,
"consumo_energetico_mj_km": 0.64,
"consumo_estrada_gasolina": null,
"classificacao_absoluta_geral": "A",
"consumo_cidade_eletrico_kmle": 34,
"consumo_estrada_eletrico_kmle": 29.6,
"classificacao_relativa_categoria": "A"
},
"emissoes": {
"co_g_km": 0,
"nox_g_km": 0,
"nmhc_g_km": 0,
"co2_fossil_g_km": 0,
"co2e_fossil_g_km": null,
"reducao_relativa_limite": "A"
}
},
"meta": {
"generated_at": "2026-04-17T22:43:03.833Z",
"request_id": "6c2f0875-84ad-4abf-9c4a-d62d017c0929"
}
}
}Erros possíveis (exemplo de payload)
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Parâmetros inválidos: page deve ser maior que 0"
}
}