Sobre esta API

Devolve a categoria do veículo a partir de marca, modelo, ano e código FIPE: hatch, sedan, SUV, crossover, picape, 4x4 ou cupê para carros; street, naked, sport, trail, custom, scooter ou touring para motos.

Envie um JSON com vehicle_type, brand, model, year e code_fipe (formato 001234-5). Não recebe imagem.

Tecnologia

LLM · Atualização: tempo real

Requisição

POST /api/v1/oracle/vehicle/classify

Autenticação HTTP Basic: public_key:secret_key em Base64. Guarde a chave secreta no servidor.

Cabeçalho	Descrição
`Authorization` Obrigatório	Chave de API em Basic: `public_key:secret_key` em Base64.
`X-Project-Id` Opcional	Projeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
`Idempotency-Key` Opcional	Repetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.

Parâmetros

Campo	Tipo e local	Descrição
`vehicle_type` Obrigatório	stringbody	`cars` ou `motorcycles`. Exemplo: `cars`
`brand` Obrigatório	stringbody	Marca. Exemplo: `Fiat`
`model` Obrigatório	stringbody	Modelo. Exemplo: `Argo`
`code_fipe` Obrigatório	stringbody	Código FIPE no formato `001234-5`. Exemplo: `001234-5`
`year` Obrigatório	integerbody	Ano do modelo. Exemplo: `2022`

1curl --request POST 'https://api.apifordevs.com/api/v1/oracle/vehicle/classify' \
2  --user "afd_live_pk_...:$AFD_SECRET_KEY" \
3  --header "X-Project-Id: $AFD_PROJECT_ID" \
4  --header 'Content-Type: application/json' \
5  --data '{"vehicle_type":"cars","brand":"Fiat","model":"Argo","code_fipe":"001234-5","year":2022}'

1import os
2import requests
3
4response = requests.request(
5    "POST",
6    "https://api.apifordevs.com/api/v1/oracle/vehicle/classify",
7    auth=("afd_live_pk_...", os.environ["AFD_SECRET_KEY"]),
8    headers={"X-Project-Id": os.environ["AFD_PROJECT_ID"]},
9    json={"vehicle_type": "cars", "brand": "Fiat", "model": "Argo", "code_fipe": "001234-5", "year": 2022},
10    timeout=30,
11)
12response.raise_for_status()
13print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/oracle/vehicle/classify", {
2  method: "POST",
3  headers: {
4    Authorization: "Basic " + Buffer.from(
5      "afd_live_pk_...:" + process.env.AFD_SECRET_KEY
6    ).toString("base64"),
7    "X-Project-Id": process.env.AFD_PROJECT_ID,
8    "Content-Type": "application/json",
9  },
10  body: JSON.stringify({"vehicle_type":"cars","brand":"Fiat","model":"Argo","code_fipe":"001234-5","year":2022}),
11  signal: AbortSignal.timeout(30000),
12});
13if (!response.ok) throw new Error(`HTTP ${response.status}`);
14console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

Categoriavehicle_size_categorystring
Modelomodelstring
Marcabrandstring
Anoyearinteger

Exemplo de resposta

1{
2  "success": true,
3  "code": 200,
4  "code_message": "A requisição foi processada com sucesso.",
5  "errors": [],
6  "header": null,
7  "data_count": 1,
8  "data": [
9    {
10      "vehicle_size_category": "hatch",
11      "model": "Argo",
12      "brand": "Fiat",
13      "year": 2022
14    }
15  ]
16}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso.	Sujeita à cobrança
`400` `bad_request` `live_key_cannot_use_dev_mode`	Arquivo ou parâmetro que a rota não consegue processar, projeto inválido, ou `dev_mode=true` com chave de produção.	Sem cobrança
`401` `unauthorized`	Credencial ausente, inválida ou revogada.	Sem cobrança
`402` `payment_required`	Saldo insuficiente ou limite de gasto diário atingido.	Sem cobrança
`403` `forbidden` `ip_not_allowed` `test_key_cannot_run_live`	E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`.	Sem cobrança
`409` `conflict`	Requisição com a mesma `Idempotency-Key` ainda em andamento.	Sem cobrança
`422` `validation_error`	Parâmetro obrigatório ausente ou fora do formato, ou `Idempotency-Key` repetida com outro conteúdo.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de requisições por minuto da chave atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`503` `service_unavailable`	Serviço desativado ou temporariamente indisponível.	Sem cobrança

Casos de uso

Precificação por categoria

Definir faixa de preço de seguro ou locação pela carroceria, sem manter tabela própria.

Normalização de frota

Padronizar a categoria de veículos importados de fontes diferentes.

Classificação de carroceria por FIPE