Catálogo

Dumping em massa de todas as configurações

GET/api/getall

Toda a configuração disponível para sua chave em uma resposta — uma entrada por carro (marca/modelo/ano/variante/acabamento). As cores não são expandidas aqui; cada entrada carrega um booleano colors_available (true = o carro pode ser repintado via ?color=, false = apenas sua pintura original). Os nomes concretos das cores estão no endpoint /colors (ou /all) do carro. Além disso, cada entrada carrega years — a faixa de anos de busca para a qual esta entrada deve ser usada: { from, to, source } onde source é successor (fim duro, uma versão mais nova existe), estimated (sem sucessor no catálogo — fim estimado) ou open (to: null, última geração) — mais next_model_year. Dentro de um modelo + variante + acabamento, essas faixas nunca se sobrepõem: um ano dado corresponde a no máximo uma entrada por linha. (Atualmente sendo implementado primeiro no host de desenvolvimento.) Acesso restrito por plano. Use para uma sincronização única em vez de por solicitação.

Solicitar

curl "https://api.vehicleimagery.com/api/getall" \
  -H "x-api-key: YOUR_API_KEY"

200 · Todas as configurações.

[
  {
    "id": 911,
    "path": "Abarth/124_Spider_Abarth/2016/Basis/base",
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "views": [
      "front",
      "front_left",
      "rear",
      "right"
    ],
    "colors_available": true,
    "years": {
      "from": 2016,
      "to": null,
      "source": "open"
    },
    "next_model_year": null
  }
]

401 · `x-api-key` ausente ou inválida.

{
  "error": "Invalid API key"
}

403 · Restrição de plano (recurso, formato ou marca não permitido) ou solicitação bloqueada.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · Nenhum dado para o caminho solicitado.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}