API para decodificador de VIN lite

Necesitas decodificar un VIN esta semana e integrar la salida en tu flujo de trabajo sin sorpresas. Al final de esta guía, podrás llamar a un verdadero endpoint de VIN Decoder Lite, analizar marca/modelo/año y otros elementos esenciales, y opcionalmente obtener detalles completos del vehículo o información de piezas de vidrio, utilizando una clave API de Zyla API Hub.

Lo que puedes construir con un decodificador de VIN lite

La API de decodificador de VIN de Europa devuelve campos de identidad del vehículo fundamentales a partir de un VIN, y su endpoint “Lite” se centra en lo esencial: país, fabricante, modelo, clase, región, WMI/VDS/VIS y año del modelo. Esto es suficiente para flujos de incorporación, preselección de piezas/catálogo, formularios de entrada y verificaciones rápidas de elegibilidad. Cuando necesites más, la misma API también ofrece un endpoint completo de decodificador de VIN y un endpoint de vidrio para referencias de parabrisas OEM/posventa.

Ilustración: API para decodificador de VIN lite

Este artículo demuestra los endpoints reales, las URL exactas, los parámetros requeridos y las solicitudes que puedes copiar y pegar que puedes enviar hoy.

Comenzando en Zyla API Hub

Abre la lista de API, suscríbete y obtén tu clave API. La autenticación es a través del encabezado HTTP Authorization: Bearer YOUR_API_KEY. La facturación es por suscripción + cuota (no por llamada). La primera API aquí ofrece una prueba de 7 días; consulta la lista para las opciones de acceso actuales.

Iniciar prueba de 7 días en la API de decodificador de VIN de Europa

Endpoints que puedes llamar

1) Decodificador de VIN (detalles completos)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder
Parámetros requeridos: vin
Propósito: Decodificar un VIN fabricado en Europa y recibir marca, modelo, año, versión, estilo de carrocería, clase de vehículo, tipo, fabricante, ubicación de fabricación y otros atributos.

Ejemplo de solicitud (muestra oficial):

curl -s -X GET "https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder?vin=WVWZZZ3BZWE689725" \
-H "Authorization: Bearer YOUR_API_KEY"

Ejemplo de respuesta (muestra oficial):

{
"Make": "Volkswagen",
"Model": "Passat",
"Model year": "1998",
"Trim level": "Generación IV",
"Body style": "5 Puertas Estate|hatchback",
"Vehicle class": "Auto mediano",
"Vehicle type": "Auto de pasajeros",
"Manufactured in": "Alemania",
"Manufacturer": "Volkswagen AG",
"Adress line 1": "Wolfsburg/Hannover",
"Adress line 2": "Wolfsburg/Hannover",
"Region": "Europa",
"Country": "Alemania",
"Note": "El fabricante produce más de 500 vehículos por año",
"Body type": "Estate|hatchback",
"Number of doors": "5",
"Number of seats": "5",
"Driveline": "2WD",
"VIN": "WVWZZZ3BZWE689725"
}

Lo que típicamente leerás de esta carga útil:

Marca, Modelo, Año del modelo: campos de identidad visibles para el usuario en formularios, catálogos e informes.
Nivel de versión, Estilo de carrocería, Tipo de carrocería: útiles para la compatibilidad de piezas y filtros de UI.
Clase de vehículo, Tipo de vehículo: segmentación de flota y análisis.
Fabricado en, Fabricante, País, Región: verificaciones de cumplimiento y enrutamiento.
Número de puertas/asientos, Transmisión: lógica de capacidad y tren motriz.

2) Decodificador de VIN Lite (esenciales rápidos)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite
Parámetros requeridos: vin
Propósito: Recuperar atributos de identidad del vehículo condensados adecuados para validaciones ligeras y autocompletar.
Notas: La descripción proporciona un ejemplo de VIN como 1C4NJPBB3FD398798; pasas tu VIN a través del parámetro de consulta vin.

Ejemplo de solicitud:

Ejemplo de respuesta:

Lo que debes extraer primero:

país, región: manejo de localización y regulaciones.
fabricante, modelo, año: etiquetas de UI y preselección de piezas.
wmi, vds, vis: segmentación de VIN de bajo nivel cuando lo necesites.
clase: verificaciones de elegibilidad y niveles de precios.

3) Vidrio (datos de piezas de parabrisas a partir del VIN)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/26811/glass
Parámetros requeridos: vin, parts
Propósito: Recuperar información detallada sobre el vidrio del vehículo por VIN, incluidos números de piezas OEM y de posventa, especificaciones, características y ajuste para componentes de vidrio.

Ejemplo de solicitud:

Ejemplo de respuesta:

Usa esto cuando tu flujo necesite candidatos a piezas inmediatamente después de que se escanee o se escriba el VIN, incluidos números de posventa que se pueden referenciar. El aviso indica que debes verificar los candidatos a piezas contra un catálogo antes de comprar.

Integración mínima: llamar a VIN Decoder Lite con Python

El fragmento a continuación llama al endpoint de VIN Decoder Lite, maneja errores HTTP e imprime los campos de identidad clave que probablemente mapearás en tus modelos.

import os
import sys
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIN = "WVWZZZ3BZWE689725"

url = "https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite"
params = {"vin": VIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

try:
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
except requests.exceptions.HTTPError as e:
print(f"Error HTTP: {e} - respuesta: {getattr(e.response, 'text', '')}", file=sys.stderr)
sys.exit(1)
except requests.exceptions.RequestException as e:
print(f"La solicitud falló: {e}", file=sys.stderr)
sys.exit(1)

data = resp.json()

# Mapear campos comúnmente necesarios en sistemas posteriores
print("VIN:", data.get("vin"))
print("Fabricante:", data.get("manufacturer"))
print("Modelo:", data.get("model"))
print("Año:", data.get("year"))
print("País:", data.get("country"))
print("Región:", data.get("region"))
print("Clase:", data.get("class"))
print("WMI/VDS/VIS:", data.get("wmi"), data.get("vds"), data.get("vis"))

Consejos:

Cache por VIN. Para la mayoría de los flujos de trabajo, los datos de identidad decodificados por VIN son estables; almacenar en caché las respuestas por VIN puede reducir las búsquedas repetidas.
Normaliza el formato donde sea necesario (por ejemplo, nombres de fabricantes) para consistencia en la visualización.
Si necesitas atributos más ricos, cambia al endpoint completo de decodificador de VIN con el mismo parámetro vin y encabezado de autorización.

Curl rápido que puedes ejecutar ahora

Copia, pega y reemplaza YOUR_API_KEY con tu clave. Este es el ejemplo oficial que devuelve marca/modelo/año y más para un VIN europeo:

Patrones de integración comunes

Autocompletar formulario: el usuario ingresa el VIN; llamas a VIN Decoder Lite para autocompletar fabricante, modelo y año. Valida el WMI de tres caracteres para verificaciones de región.
Búsqueda de preselección de piezas: decodifica el VIN primero, luego llama al endpoint de vidrio con parts=windshield para mostrar candidatos compatibles antes de la navegación del catálogo.
Trabajos de ingestión de flota: decodifica por lotes un CSV de VINs, almacena en caché por VIN y guarda “marca/modelo/año/cuerpo” normalizados para análisis.
Puertas de riesgo/elegibilidad: usa clase, estilo de carrocería (del decodificador completo) y región para dirigir a los usuarios al plan o flujo de trabajo correcto.

Notas sobre el manejo de campos que ahorran tiempo

El parámetro VIN es obligatorio en todos los endpoints mostrados aquí. Para vidrio, parts también es requerido (por ejemplo, windshield).
La autorización es a través del encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
Las formas de respuesta difieren según el endpoint; lee los campos específicos que necesitas y protege con .get() o equivalente.
Debido a que los atributos decodificados por VIN son estables, el almacenamiento en caché a corto plazo (por ejemplo, por VIN durante horas o días) reduce las llamadas duplicadas sin arriesgar la obsolescencia.

Llamando a la API desde agentes de IA a través de MCP

Si prefieres orquestar llamadas desde un cliente compatible con MCP (Claude Code, Cursor, Windsurf, etc.), apunta tu herramienta al endpoint de Zyla MCP e incluye tu clave API como un parámetro de consulta en la URL de MCP. Tu agente puede entonces llamar a los mismos endpoints mostrados arriba usando los mismos parámetros vin y parts, y el encabezado de autorización como se describe aquí. Consulta el punto de entrada de MCP:

MCP

Mantén las URL de los endpoints exactamente como se enumeran en este artículo para las llamadas de herramientas HTTP del agente.

Escenarios de prueba para verificar antes de enviar

Caminos felices: VINs conocidos devuelven el fabricante/modelo/año esperado.
Variación regional: prueba VINs de América del Norte y Europa para asegurar que tus etiquetas de UI no asuman una sola región.
Específico de vidrio: verifica que parts=windshield devuelva candidatos, y añade una nota visible para el usuario sobre la verificación del catálogo al ofrecer pedidos directos de piezas.
Manejo de errores: simula tiempos de espera y respuestas no 2xx; asegúrate de que tu flujo muestre una entrada manual de respaldo cuando la decodificación falle.

FAQ

¿Qué autenticación se requiere?
Usa el encabezado HTTP Authorization: Bearer YOUR_API_KEY en cada solicitud.

¿Qué parámetros son requeridos?
Todos los endpoints mostrados requieren vin. El endpoint de vidrio también requiere parts (por ejemplo, parts=windshield).

¿Hay un plan gratuito?
La API utiliza un modelo de suscripción + cuota (no por llamada). Consulta la página de la API para las opciones de acceso y precios actuales; hay una prueba de 7 días disponible en la lista.

¿Puedo decodificar VINs no europeos con el endpoint Lite?
El endpoint Lite acepta un parámetro vin y puede devolver campos de región y país (el ejemplo muestra un VIN de América del Norte). Usa las salidas del endpoint para ramificar tu lógica apropiadamente.

¿Cómo debería almacenar en caché los resultados?
Almacena en caché por clave VIN. Debido a que los atributos decodificados por VIN son estables, almacenar en caché por VIN ayuda a reducir las búsquedas repetidas durante reintentos de usuarios o procesamiento por lotes.

Envíalo

Obtén tu clave, accede al endpoint de VIN Decoder Lite para obtener lo esencial rápidamente, y actualiza al decodificador completo o al endpoint de vidrio cuando necesites atributos detallados o candidatos a piezas. Comienza ahora y mantén tu integración ágil con una clave API a través de más de 10,000 APIs públicas en Zyla API Hub. La prueba de 7 días comienza en la lista:

Iniciar prueba de 7 días en la API de decodificador de VIN de Europa