Tienes un VIN a la mano y necesitas convertirlo en datos estructurados de vehículos que puedes usar en tu aplicación esta semana. Al final de esta guía, harás solicitudes autenticadas a la API de Decodificación de VIN en Zyla API Hub desde curl y Node.js, recuperarás especificaciones de vehículos decodificadas y opcionalmente buscarás candidatos de partes de vidrio por VIN.
Qué hace la API de Decodificación de VIN
La API de Decodificación de VIN devuelve información estructurada para un vehículo asociado con un VIN, incluyendo marca, modelo, año del modelo, estilo de carrocería, tren motriz, especificaciones del motor y más. Los casos de uso típicos incluyen:
- Ingreso de servicio y búsqueda de partes
- Verificación de activos de flota y enriquecimiento de registros
- Comprobaciones de ajuste y compatibilidad en comercio electrónico
También hay un punto final de vidrio que recupera información detallada de vidrio por VIN y tipo de parte, incluyendo números de parte OEM y de posventa, especificaciones, características y candidatos de ajuste.
Puedes explorar la lista en Zyla API Hub aquí: API de Decodificación de VIN. Zyla es un mercado con más de 10,000 APIs públicas en categorías como finanzas, enriquecimiento de datos, IA, geolocalización, comercio electrónico y utilidades. Una cuenta, una clave, un modelo de suscripción para cada API a la que te suscribas.
Comenzando en Zyla API Hub
Para llamar a la API, necesitarás una clave de API de Zyla API Hub:
- Abre la página de la API de Decodificación de VIN.
- Haz clic en Suscribirse o Comenzar Prueba Gratuita cuando esté disponible. El mercado utiliza un modelo de suscripción más cuota (no pago por llamada). Para esta API, puedes esperar una prueba de 7 días o 50 solicitudes para comenzar; consulta la página de la API para las opciones de acceso y precios actuales.
- Copia tu clave de API desde tu panel de control.
Todas las solicitudes están autenticadas con el encabezado HTTP Authorization: Bearer YOUR_API_KEY. Puedes explorar APIs adicionales en zylalabs.com y crear una cuenta aquí: Registrarse.
Puntos finales que puedes llamar
1) Decodificar
Método: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/14977/decode
Descripción: Pasa el número VIN que deseas verificar y recibe su información.
Parámetros: No se documentan parámetros de solicitud para este punto final. Autentica con tu clave de API usando el encabezado Authorization.
Ejemplo oficial de curl (copia/pega tal cual):
curl -s -X GET "https://zylalabs.com/api/6580/vin-decode-api/14977/decode"
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta JSON oficial:
{
"VIN": "JTEBU14RX30013995",
"Manufacturer": "Toyota Motor Corp",
"Adress line 1": "1 Toyota-cho Toyota -Shi",
"Adress line 2": "471-8571 Aichi-Ken",
"Region": "Asia",
"Country": "Japan",
"Note": "Manufacturer builds more than 500 vehicles per year",
"Entered VIN": "JTEBU14RX30013995",
"Corrected VIN": "JTEBU14RX30013995",
"Squish VIN": "JTEBU14R30",
"WMI": "JTE",
"VIS identifier": "N/A",
"VDS": "BU14RX30",
"Year identifier": "3",
"Serial number": "013995",
"VIN type": "normal",
"Check digit": "valid",
"Make": "Toyota",
"Model": "4Runner",
"Model year": "2003",
"Body style": "4 Doors SUV",
"Engine type": "V6",
"Fuel type": "Gasoline",
"Transmission": "Automatic",
"Manufactured in": "Japan",
"Body type": "SUV",
"Number of doors": "4",
"Number of seats": "5",
"Displacement SI": "3998",
"Displacement CID": "244",
"Displacement Nominal": "4.0",
"Engine head": "DOHC",
"Engine valves": "24",
"Engine cylinders": "6",
"Engine aspiration": "Naturally",
"Compression ratio": "10.0",
"Engine HorsePower": "245",
"Engine KiloWatts": "183",
"Automatic gearbox": "4AT",
"MPG city": "15-17",
"MPG highway": "19-21",
"Driveline": "4WD",
"Anti-Brake System": "4-Wheel ABS",
"Front brake type": "Disc",
"Rear brake type": "Drum",
"Front suspension": "Independent",
"Rear suspension": "Live",
"Front spring type": "Coil",
"Rear spring type": "Coil",
"Tire front": "265/70R16",
"Tire rear": "265/70R16",
"GVWR range": "5001-6000"
}Lo que generalmente leerás de esta carga útil:
- Marca, Modelo, Año del modelo, Estilo de carrocería, Tipo de carrocería
- Tipo de motor, cilindros, desplazamiento, caballos de fuerza, tipo de combustible
- Transmisión, tren motriz, detalles de frenos y suspensión
- Verificador de dígitos y segmentos WMI/VDS para lógica de validación
2) Vidrio
Método: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/26921/glass
Descripción: Recupera información detallada de vidrio del vehículo por VIN, incluyendo números de parte OEM y de posventa, especificaciones, características y ajuste para cada componente de vidrio.
Parámetros:
- vin (cadena, requerido): JTEBU14RX30013995
- parts (cadena, requerido): parabrisas
Ejemplo oficial de curl (copia/pega tal cual):
Ejemplo de respuesta JSON oficial:
Lo que generalmente leerás de esta carga útil:
- Números de parte OEM y de posventa para componentes de vidrio específicos
- Características y especificaciones de material para decidir ajuste y pedido
- Descargo de responsabilidad indicando que los candidatos deben ser verificados antes de ordenar
Tu primera llamada de Node.js
A continuación se muestra un ejemplo mínimo de Node.js utilizando fetch nativo (Node 18+). Muestra cómo llamar al punto final Decode, verificar un error HTTP y leer campos comúnmente utilizados de la respuesta JSON. No se documentan parámetros de solicitud para este punto final; se requiere el encabezado de autenticación.
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function decodeVin() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/14977/decode";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
// Considera tiempos de espera/reintentos cortos en producción; mantén esto mínimo aquí para claridad.
});
if (!res.ok) {
const text = await res.text();
throw new Error(`Error en la API de Decodificación de VIN: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
// Extrae los campos que tu aplicación probablemente necesita.
const summary = {
vin: data["VIN"],
make: data["Make"],
model: data["Model"],
year: data["Model year"],
bodyType: data["Body type"],
engine: {
type: data["Engine type"],
cylinders: data["Engine cylinders"],
horsepower: data["Engine HorsePower"],
displacementSi: data["Displacement SI"]
},
transmission: data["Transmission"],
driveline: data["Driveline"]
};
console.log("Resumen decodificado:", summary);
}
decodeVin().catch(err => {
console.error(err);
process.exit(1);
});Llamada de Node.js para Vidrio
Esta muestra utiliza los parámetros de consulta documentados vin y parts. Imprime números de parte OEM y de posventa para el componente de vidrio solicitado.
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function getGlassCandidates() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/26921/glass?vin=JTEBU14RX30013995&parts=windshield";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`Error en la API de Vidrio: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
const components = data.glass?.windshield || [];
for (const c of components) {
console.log({
oem: c.oem_part_number,
aftermarket: c.aftermarket_part_number,
type: c.glass_type,
features: c.features
});
}
}
getGlassCandidates().catch(err => {
console.error(err);
process.exit(1);
});Detalles prácticos que ahorran tiempo
- Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY. No coloques la clave en un parámetro de consulta.
- Cacheo: Los VIN son identificadores estáticos para una configuración de vehículo específica. Almacena en caché los resultados decodificados claveados por VIN para reducir llamadas y mejorar la latencia en búsquedas repetidas.
- Manejo de errores: Registra respuestas no 2xx y el cuerpo de la respuesta para ayudar en la depuración. Mantén las claves sensibles fuera de los registros.
- Tasa y cuota: Las APIs de Zyla utilizan suscripción con cuotas (no pago por llamada). Para esta API, el primer acceso típicamente incluye una prueba de 7 días o 50 solicitudes. Consulta la lista para detalles actuales.
- Uso de datos: Al usar datos de candidatos de vidrio, nota el descargo de responsabilidad en la respuesta y verifica los números de parte contra catálogos OEM/posventa antes de ordenar.
Patrones de integración en el mundo real
- Programación de servicios: Escanea o ingresa un VIN al momento del check-in, llama a Decodificar para obtener el año del modelo, tipo de motor y tren motriz, luego completa automáticamente la orden de reparación con la hoja de especificaciones correcta.
- Comercio electrónico de partes: Usa Decodificar para prefiltrar partes compatibles. Para productos de vidrio, llama al punto final de Vidrio con vin y parts para mostrar números de parte y especificaciones de candidatos en PDPs.
- Enriquecimiento de flota: Ingiere VINs de telemática o títulos y completa atributos como desplazamiento, caballos de fuerza y rango de GVWR para mejorar la planificación de rutas y mantenimiento.
Llama a la API desde agentes de IA a través de MCP
Cada API en Zyla API Hub también puede ser llamada desde agentes de IA (Claude Code, Cursor, Windsurf y cualquier cliente compatible con MCP) a través del punto final MCP. Apunta tu cliente a:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Consulta la documentación de MCP aquí: MCP. Una vez configurado, tu agente puede invocar las mismas herramientas de la API de Decodificación de VIN usando tu clave de API de Zyla—sin pasos adicionales de autenticación por servicio.
Curl completo que puedes ejecutar ahora
Si solo necesitas verificar la conectividad y la autenticación, ejecuta el ejemplo oficial de Decodificar (reemplaza primero YOUR_API_KEY):
Luego prueba el punto final de Vidrio con parámetros de consulta vin y parts:
Dónde encontrar documentación y gestionar tu clave
- Listado de API: API de Decodificación de VIN
- Inicio del mercado: zylalabs.com
Si estás integrando a través de múltiples productos, la clave unificada de Zyla y la suscripción simplifican la autenticación y la facturación. Puedes descubrir otras APIs de automoción y enriquecimiento de datos directamente desde el mercado a medida que amplías la cobertura.
FAQ
¿Hay un plan gratuito?
No hay plan gratuito. El mercado utiliza suscripción con cuotas. Para esta API, puedes esperar una prueba de 7 días o 50 solicitudes para comenzar. Consulta la página de la API para las opciones de acceso y precios actuales.
¿Cómo me autentico?
Envía el encabezado Authorization: Bearer YOUR_API_KEY con cada solicitud a los puntos finales mostrados arriba.
¿Qué parámetros acepta el punto final Decodificar?
No se documentan parámetros de solicitud para el punto final Decodificar. Usa el encabezado Authorization como se muestra en el ejemplo oficial y lee el JSON devuelto para los detalles del VIN.
¿Cómo solicito datos de vidrio para un componente específico?
Llama al punto final de Vidrio con parámetros de consulta vin y parts. Ejemplo: parts=windshield. La respuesta incluye números de parte y especificaciones de candidatos OEM y de posventa. Verifica los candidatos contra catálogos antes de ordenar.
¿Puedo llamar a esto desde un agente de IA?
Sí. Usa el punto final MCP de Zyla en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY en cualquier cliente compatible con MCP. Consulta la documentación de MCP para la configuración.
¿Listo para construir? Crea tu cuenta, obtén una clave de API y envía tu primera integración hoy: Registrarse. Luego abre la página de la API de Decodificación de VIN y suscríbete desde dentro del mercado.
