Ya sabes qué coche es

Tiene un número. Lo que necesita es una marca, un modelo, una variante, un acabado y ocho imágenes. Convertir uno en el otro es la parte que nadie quiere construir, así que es la parte que construimos.

Llega en un feed de stock, en un documento de registro, en una hoja de cálculo de la empresa de arrendamiento.

GET /vin/WVWZZZ1KZAW000000

{"vin": "WVWZZZ1KZAW000000","fabricante": "Volkswagen","modelo": "Golf","año": 2024,"cuerpo": "Hatchback","transmisión": "MANUAL","vehículo": {"coincidente": true,"confianza": "alta","marca": "Volkswagen","color": "Acapulco Blue Metallic","imágenes": { "front_left": "https://cdn…", … }}}
El Volkswagen Golf coincidió con un VIN

Respuestas de ejemplo, acortadas. Los identificadores son placeholders, los vehículos y colores a su lado son salida real del catálogo.

Qué sucede entre el número y la imagen

Tres cosas, en una sola solicitud. La del medio es la razón por la que esto es más difícil de lo que parece, y la razón por la que la respuesta te dice qué tan seguro es.

01

Decodificar

Un VIN se convierte en una marca, modelo, año, carrocería, motor y caja de cambios. Una matrícula se convierte en lo mismo, más el VIN detrás y el color en el que se registró el coche. El texto libre se convierte en la entrada de catálogo a la que apuntaban las palabras.

02

Coincidencia

El vehículo decodificado se compara con el catálogo, y la respuesta indica qué tan bien coincide. Ese campo existe porque un resultado cercano es un resultado normal en este negocio, y debes ser tú quien decida qué hacer al respecto.

03

Entregar

La misma respuesta lleva una URL de imagen firmada por vista que tu plan permite. Sin una segunda llamada, sin una tabla de mapeo propia, sin un trabajo nocturno que reconcilie dos sistemas.

Un coche blanco vuelve blanco

Una búsqueda de matrícula sabe el color en el que se registró el vehículo, y lleva eso a la solicitud de imagen. Así, una página de intercambio muestra el coche que el cliente reconocerá en el estacionamiento, no un sustituto plateado genérico que le haga preguntarse si tiene el vehículo correcto.

Cuando un color registrado no está en el catálogo para ese modelo, se recurre al acabado estándar y vehicle.color indica lo que se utilizó realmente. Ese campo es la razón por la que una página puede imprimir "el color mostrado puede diferir" solo cuando es cierto, en lugar de dejar esa advertencia bajo cada auto para siempre y entrenar a las personas a desconfiar de las imágenes.

Después de la búsqueda, el vehículo coincidente es una entrada de catálogo ordinaria. Si quieres cambiar el color, o en los ocho ángulos, o recortado para tu propia escena, es el mismo vehículo y los mismos puntos finales que todo lo demás en este sitio.

La respuesta dice cuán segura es

Emparejar un coche real con una entrada del catálogo no siempre es limpio: restylings, versiones específicas del mercado, una variante que se vendió durante once meses. En lugar de ocultarlo, la respuesta la califica.

"alta"La entrada del catálogo es el vehículo. Publíquela.
"media"Modelo correcto, algo por debajo es incierto: una variante, un año de restyling. Perfecto para una miniatura de lista, vale la pena echar un vistazo antes de una imagen principal.
"low"Lo más cercano que tenemos. Trátalo como una sugerencia, no como una respuesta, y considera mostrar nada en su lugar.

Antes de preguntar

¿Qué países cubre la búsqueda de matrícula?

El Reino Unido, la mayor parte de Europa, los Estados Unidos y un número de mercados adicionales. Las matrículas se repiten en las fronteras, así que pasa el país cuando lo sepas. Sin él, la búsqueda tiene que adivinar, y adivinar es cómo una placa británica se convierte en una furgoneta holandesa.

¿Qué ocurre cuando nada coincide?

Obtiene matched: false y ninguna imagen, en lugar de lo más cercano disfrazado de resultado. Un auto equivocado en una lista cuesta más que un espacio vacío.

¿Es la data decodificada suya o de un tercero?

La decodificación proviene de los datos de vehículos que licenciamos, la misma fuente sobre la que se construye el catálogo. Por eso también se pueden escribir los términos de la licencia: nada aquí fue raspado de otro sitio.

¿VIN y matrícula son parte de todos los planes?

No, son complementos. Su clave los tiene o no, y GET /api/me le dice cuáles. Pídanoslo y los activamos.

¿Puedo buscar un coche y luego cambiar el color de todos modos?

Sí. La búsqueda completa el color registrado porque generalmente es lo que se quiere, pero el vehículo al que coincide es una entrada de catálogo ordinaria después. Pídalo en cualquier pintura que lleve el modelo.

Envíenos veinte matrículas

Reales de su propio stock o de sus propios formularios de intercambio. Los pasamos y enviamos lo que salió, incluyendo los que no coincidieron, porque ese número le dice más sobre si esto funciona para usted que los que sí coincidieron.