Imagen
Resuelve una URL de imagen firmada
OBTENER/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
El punto final principal. Devuelve metadatos más una image_url firmada que incrustas directamente en un <img>.
Agregue cualquier opción como parámetro de consulta. Cualquier cosa no disponible para el auto o no permitida por su plan se reemplaza con el valor válido más cercano y se informa en errornotes (en lugar de fallar).
Ejemplos
?format=webp&width=1200— WebP, 1200 px de ancho.?ratio=16:9&format=jpeg— rellenado a 16:9.?mirroring=true— coche en un suelo de showroom reflectante.?transparency=true&format=png— recortado sobre fondo transparente.?color=wine_red— Repintado en el color de casa wine_red.?color=Racing%20Red&shadow=true— Pintura de catálogo Kia Racing Red más sombra de estudio.
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. |
view requerido | cadena | Nombre de la vista, ver /api/views (por ejemplo, frontal, frontal_izquierdo, trasero). |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. `auto` elige WebP. El original es PNG. pngwebpjpegavifauto |
resolution | cadena | Preajuste de tamaño/calidad (anulado por ancho/calidad explícito). defaultthumbsmallmediumlargefull |
ratio | cadena | Rellenar hasta una relación de aspecto. `default` = nativa. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | integer | Ancho explícito en px (ajustado a la escalera de ancho). |
height | integer | Altura explícita en px. |
quality | integer | Calidad del codificador (40:100). |
color | cadena | Color de pintura por nombre (insensible a mayúsculas y minúsculas; codificar espacios en URL, por ejemplo, `Racing%20Red`). El auto se repinta bajo demanda, el acabado es fiel, se preservan las reflexiones y los acabados. El conjunto de colores de un auto se muestra en `/colors` (colores de la casa + colores de su marca); cualquier color activo de `/api/colors` puede ser solicitado. Color desconocido → pintura predeterminada + nota de error `F04`. Se combina con todas las demás opciones. |
shadow | cadena | Sombra de suelo de estudio — renderizada en el momento de la entrega, disponible para cada vista exterior. Con `mirroring=true` esto controla la sombra de la parte inferior en su lugar. truefalse |
transparency | cadena | Fondo transparente recortado — disponible para cada vista exterior (usar con PNG/WebP). truefalse |
ground | cadena | Coloca el coche en el suelo (necesita una variante transparente). true |
mirroring | cadena | Suelo reflectante. `true` = con sombra del chasis, `clean` = solo reflejo. Necesita una variante transparente. trueclean |
