Catálogo

Colores para una configuración

OBTENER/api/{brand}/{model}/{year}/{variant}/{trim}/colors

Colores mostrados para este coche, deliberadamente compactos: los colores de la casa de Vehicleimagery (disponibles en todos los coches) más los colores de la marca de este coche. Cualquier color activo del catálogo puede seguir solicitándose en cualquier coche. Pasa un nombre como ?color= en el punto final de la imagen. El catálogo completo con la combinación de marcas está en /api/colors; también consulta la guía *Colores de pintura* en /info/guides/colors.

Los colores pertenecen a la marca: si esta configuración exacta no está en el catálogo (por ejemplo, un acabado desconocido), se devuelven los colores de la marca de todos modos, con id: null y vehicle_found: false. Solo una marca desconocida responde 404.

API v2 complementario: para un auto con imágenes complementarias la respuesta también incluye any_hex_color: true. Su pintura puede establecerse a cualquier color hexadecimal de 6 dígitos, por ejemplo, ?color=c8102e.

Parámetros de ruta

Nombre	Tipo	Descripción
`brand` requerido	cadena	Nombre de marca o alias (no distingue entre mayúsculas y minúsculas).
`model` requerido	cadena	Nombre del modelo.
`year` requerido	integer	Año del modelo (4 dígitos). Si falta el año exacto, se usa la generación más cercana disponible (nota de error `Y01`).
`variant` requerido	cadena	Variante de carrocería.
`trim` requerido	cadena	Nivel de acabado.

Parámetros de consulta

Nombre	Tipo	Descripción
`version`	cadena	Resultados de una sola versión: `v1` = imágenes estándar, `v2` = complemento de la API v2 (sin retroceso a las imágenes estándar). Sin él: todo lo que permita tu clave. No permitido para tu clave → `403`. `v1v2`

Solicitud

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/colors?version=v1" \
  -H "x-api-key: YOUR_API_KEY"

200 · Colores.

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

401 · `x-api-key` faltante o inválida.

{
  "error": "Invalid API key"
}

403 · Restricción del plan (característica, formato o marca no permitidos) o solicitud bloqueada.

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

404 · No hay datos para la ruta solicitada.

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