Catálogo

Dumping em massa de todas as configurações

GET/api/getall

Todas as configurações disponíveis para sua chave em uma resposta (grande): uma entrada por carro e cor (cada carro lista as cores da casa mais as cores da marca). Acesso restrito ao plano. Use para uma sincronização única em vez de por solicitação.

Adicional da API v2: com o adicional, carros com imagens adicionais também são incluídos e carregam groups, por exemplo, { id: 900000003, path: "Audi/Q9/2026/SUV/Default", views: ["front", "front_left", …], groups: [{ group: "hero", images: 8 }, { group: "360", images: 64 }, { group: "lifestyle", images: 14 }] }. Carros que existem apenas no adicional têm ids a partir de 900000000.

Parâmetros de consulta

Nome	Tipo	Descrição
`version`	string	Resultados de apenas uma versão: `v1` = imagens padrão, `v2` = add-on da API v2 (sem recair nas imagens padrão). Sem ele: tudo o que sua chave permite. Não permitido para sua chave → `403`. `v1v2`

Solicitar

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

200 · Todas as configurações.

[
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "resolution": "default",
    "format": "png",
    "color": "default"
  },
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "resolution": "default",
    "format": "png",
    "color": "wine_red"
  }
]

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."
}