Tienes un VIN de 17 caracteres de un vehículo de EE. UU. y necesitas la marca, modelo, año, motor y especificaciones de construcción relacionadas rápidamente. Al final de este artículo, podrás llamar a un endpoint real de decodificación de VIN en Zyla API Hub, analizar la respuesta y enviarla detrás de tu aplicación, webhook o herramienta interna esta semana.
Qué hace esta API y cuándo usarla
La API de Decodificador de VIN en Zyla API Hub expone múltiples endpoints de solo lectura para convertir un VIN en especificaciones del fabricante. El endpoint de Decodificador de VIN de EE. UU. devuelve la marca, modelo, año y otros atributos de fábrica cuando están disponibles de la fuente. No devuelve historial de accidentes, registros de robo, marcas de título o datos de propietarios anteriores. La cobertura es más fuerte para los VIN de EE. UU.; también están disponibles endpoints de Europa y del Mundo, con campos potencialmente más limitados.
Los casos de uso típicos incluyen:
- Ingreso de mercado automotriz: normalizar listados con marca/modelo/trim verificados.
- Formularios de cotización de seguros: completar automáticamente la clase de carrocería, puertas y transmisión desde un VIN.
- Gestión de inventario de flotas: estandarizar los metadatos del vehículo al momento de la incorporación.
- Flujos de búsqueda de piezas: mapear el VIN a notas de serie/trim para filtrado de compatibilidad.
Puedes acceder a cada API en Zyla API Hub con una cuenta, una clave de API y un modelo de suscripción + cuota. El mercado alberga más de 10,000 APIs públicas en diversas categorías si necesitas agregar enriquecimiento más tarde sin nuevos flujos de autenticación.
Comenzando en Zyla API Hub
Abre la lista de la API de Decodificador de VIN en Zyla API Hub, comienza la prueba o suscríbete, y obtén tu clave. La autenticación es a través del encabezado de Autorización usando tu token de portador. La primera API a la que te suscribes generalmente ofrece una prueba de 7 días o 50 solicitudes; no hay Plan Gratuito. Para las opciones de acceso y precios actuales, utiliza la página de listado.
Comienza la prueba de 7 días en la API de Decodificador de VIN
Endpoints que puedes llamar
Todos los endpoints a continuación son GET. Incluye tu clave de API en el encabezado de Autorización como “Bearer YOUR_API_KEY”. Solo se admiten los parámetros que se muestran aquí; no agregues otros.
Decodificador de VIN de EE. UU.
Pasa un VIN de 17 caracteres y recibe especificaciones del fabricante: marca, modelo, año, motor y transmisión cuando la fuente los informe. La cobertura de EE. UU. es típicamente más rica que la de Europa o el Mundo.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder
- Parámetro de consulta requerido:
- vin: JTMZ431V10D144875
Ejemplo de cURL (copia y pega y reemplaza YOUR_API_KEY si es necesario):
curl -s -X GET "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder?vin=JTMZ431V10D144875" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta:
{
"Suggested VIN": "JTMZ431V1!D144875",
"Error Code": "1,11,14,400",
"Vehicle Descriptor": "JTMZ431V*0D",
"Make": "TOYOTA",
"Manufacturer Name": "TOYOTA MOTOR CORPORATION",
"Model": "RAV4",
"Plant City": "OHBU",
"Series": "ASA33L/ASA38L/GSA33L/GSA38L",
"Trim": "LE (X Grade)",
"Vehicle Type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"Plant Country": "JAPAN",
"Plant Company Name": "Toyota Industries Corporation, Nagakusa Plant",
"Plant State": "AICHI",
"Trim2": "X Grade",
"Series2": "Wagon body style",
"Note": "Without Third Seat",
"NCSA Body Type": "Compact Utility (Utility Vehicle Categories Small and Midsize )",
"NCSA Make": "Toyota",
"NCSA Model": "RAV4 *",
"Body Class": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]",
"Doors": "5",
"Drive Type": "4x2",
"Gross Vehicle Weight Rating From": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"Trailer Type Connection": "Not Applicable",
"Trailer Body Type": "Not Applicable",
"Bus Floor Configuration Type": "Not Applicable",
"Bus Type": "Not Applicable",
"Custom Motorcycle Type": "Not Applicable",
"Motorcycle Suspension Type": "Not Applicable",
"Motorcycle Chassis Type": "Not Applicable",
"VIN": "JTMZ431V10D144875"
}Qué mirar primero:
- Marca, Modelo, Tipo de Vehículo, Clase de Carrocería: para la visualización de UI y filtros de búsqueda.
- Puertas y Tipo de Tracción: para seguros, mercado y flujos de servicio.
- Serie/Trim/Serie2/Trim2/Nota: para ajuste de piezas y características específicas de trim.
- “VIN Sugerido” más “Código de Error”: posibles pistas de corrección y códigos de estado cuando el VIN incluye problemas o caracteres no estándar.
Decodificador de VIN de Europa
Decodifica VINs de Europa. La disponibilidad de datos puede ser más limitada que las respuestas de EE. UU.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1507/europe-vin-decoder
- Parámetro de consulta requerido:
- vin: WVWZZZAUZEW389248
Ejemplo de cURL:
Ejemplo de respuesta:
Decodificador de VIN del Mundo
Decodifica VINs de fabricantes de todo el mundo. La disponibilidad de datos puede ser limitada en comparación con EE. UU.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1508/world-vin-decoder
- Parámetro de consulta requerido:
- vin: WVWZZZAUZEW389248
Ejemplo de cURL:
Ejemplo de respuesta:
Ejemplo rápido de Python usando el endpoint de EE. UU.
Este fragmento llama al Decodificador de VIN de EE. UU., falla rápidamente en no-200 y extrae los campos que probablemente mostrarás en un formulario o listado. Reemplaza YOUR_API_KEY antes de ejecutar.
import requests
API_URL = "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder"
API_KEY = "YOUR_API_KEY" # establece tu clave
VIN = "JTMZ431V10D144875"
resp = requests.get(
API_URL,
params={"vin": VIN},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()
# Carga mínima de visualización
vehicle = {
"vin": data.get("VIN"),
"make": data.get("Make"),
"model": data.get("Model"),
"vehicle_type": data.get("Vehicle Type"),
"body_class": data.get("Body Class"),
"doors": data.get("Doors"),
"drive_type": data.get("Drive Type"),
"series": data.get("Series"),
"trim": data.get("Trim"),
"note": data.get("Note"),
}
print(vehicle)
# Diagnósticos opcionales / pistas de corrección
suggested = data.get("Suggested VIN")
error_code = data.get("Error Code")
if suggested or error_code:
print({"suggested_vin": suggested, "error_code": error_code})Comportamiento, respuestas y notas de integración que ahorran tiempo
- Autenticación: Agrega Authorization: Bearer YOUR_API_KEY a cada solicitud.
- Unidades y formatos:
- Las clases de peso en las respuestas de EE. UU. aparecen como rangos legibles por humanos (por ejemplo, “Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)”). No asumas que son solo numéricas.
- Campos como “Puertas” y “Tipo de Tracción” pueden ser cadenas; normaliza si requieres valores solo numéricos.
- Manejo de errores:
- Si aparece “Código de Error”, trátalo como una cadena de estado/contexto del decodificador. Considera registrarlo para analizar la calidad de entrada del VIN.
- “VIN Sugerido” puede ayudar a mostrar una UI de corrección del usuario cuando un carácter es ambiguo o mal escrito.
- Presencia de campos: No todos los VIN devuelven todos los campos. Siempre verifica si los atributos opcionales son nulos (por ejemplo, Series2, Trim2, Note).
- Cacheo: Los metadatos del VIN son estáticos para un vehículo. Cachea por VIN indefinidamente en tu aplicación o CDN para evitar llamadas innecesarias.
- Rendimiento: Zyla API Hub utiliza un modelo de suscripción + cuota, no pago por llamada. La primera API que agregas generalmente incluye una prueba de 7 días o 50 solicitudes para evaluar. Consulta el listado para los detalles de tu plan actual.
Elegir entre los endpoints de EE. UU., Europa y el Mundo
Si manejas principalmente vehículos de EE. UU., utiliza el endpoint de EE. UU. para los atributos más ricos. Si tus VIN abarcan múltiples regiones, puedes enrutar por WMI (primeros 1–3 caracteres) o intentar primero los endpoints específicos de la región, cayendo de regreso al Mundo. La tabla a continuación resume las diferencias clave.
| Endpoint | HTTP | Ruta | Parámetro VIN | Nota sobre disponibilidad de datos |
|---|---|---|---|---|
| Decodificador de VIN de EE. UU. | GET | /api/74/vin-decoder-api/139/usa-vin-decoder | vin | La cobertura de EE. UU. es típicamente más rica que en otras regiones. |
| Decodificador de VIN de Europa | GET | /api/74/vin-decoder-api/1507/europe-vin-decoder | La disponibilidad de datos puede ser limitada en comparación con los Estados Unidos. | |
| Decodificador de VIN del Mundo | GET | /api/74/vin-decoder-api/1508/world-vin-decoder | La disponibilidad de datos puede ser limitada en comparación con los Estados Unidos. |
Casos de uso prácticos que puedes implementar esta semana
- Mejorador de listados de mercado:
- Al crear un listado, llama al endpoint de EE. UU. con el VIN y bloquea los campos de Marca/Modelo/Puertas/Clase de Carrocería. Superficie Trim y Series como etiquetas verificadas de solo lectura.
- Almacena “VIN Sugerido” y muestra una advertencia ligera en la UI si difiere del VIN ingresado para prevenir registros de inventario incorrectos.
- Formularios de reserva de servicio:
- Completa automáticamente la clase de carrocería y la transmisión en las UIs de programación. Usa “Nota” y “Series2” para resaltar texto de asesoría de compatibilidad para ciertos servicios.
- Compatibilidad de piezas:
- Mapea Series y Trim a las categorías de tu catálogo de piezas. Cachea resultados para reducir llamadas repetidas al decodificador durante la navegación.
- Incorporación de flotas:
- Ingresa en bloque VINs y enriquece cada registro de vehículo a medida que se escanea. Persiste las especificaciones decodificadas y expón Marca/Modelo/Tipo de Tracción para informes posteriores.
Llamando al Decodificador de VIN desde un agente de IA a través de MCP
Si prefieres orquestar llamadas a través de un agente de IA, Zyla proporciona un endpoint compatible con MCP que funciona con clientes populares. Dirige tu agente a:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Después de configurar tu cliente, el agente puede llamar a la misma API de Decodificador de VIN que viste arriba desde tu entorno de codificación. Para detalles sobre la configuración y herramientas de MCP, consulta la documentación de MCP. Debido a que las solicitudes de MCP aún consumen tu cuota de suscripción, reutiliza los resultados de VIN en caché dentro de la sesión del agente para evitar búsquedas duplicadas.
Lista de verificación de producción
- Valida la longitud del VIN (17 caracteres) del lado del cliente para reducir llamadas innecesarias.
- Registra y monitorea las ocurrencias de “Código de Error” por formulario de origen o socio para detectar problemas de calidad de datos temprano.
- Estrategia de respaldo: Si procesas VINs internacionales, intenta primero el endpoint regional (por ejemplo, EE. UU., luego Europa), luego el Mundo como un catchall.
- Cachea respuestas decodificadas por VIN sin expiración, y agrega una opción de actualización manual para equipos de soporte.
- Elimina PII: las respuestas contienen solo datos de construcción del vehículo; seguro para almacenar en bases de datos de productos.
FAQ
¿La API de Decodificador de VIN proporciona historial de accidentes o de propiedad?
No. Los endpoints devuelven especificaciones del fabricante (por ejemplo, Marca, Modelo, Clase de Carrocería, Puertas) cuando están disponibles. No incluyen historial de accidentes, registros de robo, marcas de título o datos de propietarios anteriores.
¿Qué autenticación se requiere?
Usa Authorization: Bearer YOUR_API_KEY en cada solicitud. Obtén tu clave de la lista de API después de suscribirte o comenzar una prueba.
¿Hay un plan gratuito?
No hay Plan Gratuito. La primera API que agregas generalmente incluye una prueba de 7 días o 50 solicitudes para evaluación. Consulta el listado para las opciones de acceso y precios actuales.
¿Qué endpoint debo usar para autos de EE. UU.?
Usa el endpoint de Decodificador de VIN de EE. UU. para VINs de EE. UU.; generalmente devuelve el conjunto de atributos más rico. Para VINs europeos u otras regiones, usa los endpoints de Europa o del Mundo, teniendo en cuenta que los datos pueden ser más limitados.
¿Cómo debo manejar VINs mal formados?
Valida la longitud antes de llamar. Si la respuesta incluye “VIN Sugerido” o un “Código de Error”, muéstralo a tus usuarios para corregir errores tipográficos o caracteres ambiguos, y registra el evento para QA.
¿Listo para decodificar tu primer VIN e integrarlo en tu aplicación? Crea tu cuenta en Zyla API Hub, obtén tu clave de API y comienza la prueba aquí: Comienza la prueba de 7 días en la API de Decodificador de VIN.
