Método HTTP GET
Autenticação: API Key + API Secret
Comparação
Melhor alternativa por categoria
Retorna o melhor candidato alternativo para o veículo informado.
Resumo técnico
- Método
- Método HTTP GET
- Rota
- /vehicles/{vehicle_id}/best-alternative
- URL completa
- https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1/vehicles/{vehicle_id}/best-alternative
Quando usar
Use em sugestões de substituição recomendada.
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 base. | - |
Campos principais da resposta
Retorna um único objeto RankingBaseItem em `data.data`.
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| data.data.vehicleId | string | Não | Campo retornado pelo endpoint. | - |
| data.data.eficienciaMediaReferencia | string | Não | Campo retornado pelo endpoint. | - |
| data.meta.filters_applied.vehicle_id | string | Não | Campo retornado pelo endpoint. | - |
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/vehicles/001af754-592a-42ce-8227-01c958d4de3c/best-alternative" \
-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": {
"vehicleId": "001c09ef-0e8a-495f-a460-c34d00bc83f5",
"marca": "Toyota",
"modelo": "Corolla Hybrid",
"ano": 2025,
"categoria": "Sedan",
"ecoScore": 78.1,
"eficienciaMediaReferencia": 14.3
},
"meta": {
"generated_at": "2026-04-17T22:03:16.372Z",
"request_id": "762f6abe-1846-4c04-a979-e348c3e0c072",
"filters_applied": {
"vehicle_id": "001af754-592a-42ce-8227-01c958d4de3c"
}
}
}
}Erros possíveis (exemplo de payload)
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Parâmetros inválidos: page deve ser maior que 0"
}
}