GUIA DE INTEGRAÇÃO

Verifique os veículos do seu servidor.

Autenticação

Crie uma conta e copie sua senha de Minha conta. Usar Authorization: Bearer TU_CLAVE ou o cabeçalho X-API-Key. Não coloque chaves em URLs, HTML público ou JavaScript do navegador.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Filtros e paginação

Parâmetro	Usar
brand / brand_id	Marca ou identificador exato.
model / model_id	Parte do nome ou identificador.
cc, kw, cv	Valores numéricos exatos.
y1, y2	Sobreposição com o intervalo de anos. Para um ano específico, use ambos com o mesmo valor.
limit	Entre 1 e 100; padrão 50.
offset	A partir de 0. Use next_offset enquanto has_more for verdadeiro.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Exemplo ilustrativo de formato. Os resultados específicos dependem do catálogo.

Filtros do catálogo atualizado

generation, fuel, technology, engine: Valores de texto exatos.

fuel=Diésel&technology=TDI&engine=BKD

Equilíbrio e limites

Cada resposta 200 consome uma consulta ao banco de dados, mesmo que não haja correspondências. Erros não consomem equilíbrio. O limite por minuto é compartilhado entre as chaves do mesmo usuário e verificado nos últimos 60 segundos.

As consultas mensais atuais ao banco de dados são gastas primeiro e depois as adicionais adquiridas. As recargas são mantidas na renovação do mês. Os planos gratuitos são renovados mediante uso ou via cron; Os planos de pagamento só são reabastecidos após um pagamento verificado. Se o período expirar, seu saldo mensal não estará mais disponível.

HTTP	Significado
400	Filtros ou intervalo de anos inválidos.
401	Chave de API ausente.
402	Nenhuma consulta de banco de dados disponível.
403	Chave inativa ou assinatura sem acesso.
429	Limite por minuto; Tentar novamente depois: 60.
500 / 503	Erro de serviço ou conexão.

Escopo de dados

Um ano final nulo indica que o ano final não é conhecido e é tratado como um intervalo aberto durante a filtragem. Isso não prova que o modelo ainda esteja sendo fabricado. Os intervalos invertidos são excluídos com revisão pendente. Combustível, corpo e outros campos não podem ser informados. Estes dados não garantem a compatibilidade de uma peça de reposição: esta relação deve ser fornecida e validada pela loja.