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.

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.

Solicitud

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/colors" \
  -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."
}