El historial oficial del fabricante, como API
Una sola llamada autenticada devuelve el historial oficial de mantenimiento de un vehículo en JSON estructurado: fechas, kilometraje, el taller que realizó el trabajo y en qué consistió. Para mostrarlo en sus anuncios, sus tasaciones o su flujo de peritaje.
El acceso se acuerda directamente con nosotros: indíquenos su volumen y su caso de uso y le enviaremos una tarifa.
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Serie 3",
"yearOfManufacture": 2018,
"fuelType": "Diésel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Madrid Norte",
"serviceType": "Cambio de aceite",
"serviceActions": [
"Aceite de motor y filtro",
"Filtro de habitáculo"
]
}
],
"hasServiceHistory": true
}
}
Para quién está pensada
Si el historial de mantenimiento de un vehículo influye en lo que deciden sus usuarios, debería estar dentro de su producto y no en una pestaña aparte.
Portales y remarketing
Muestre el historial dentro del propio anuncio. Los compradores pujan con más confianza y los vendedores reciben menos preguntas sobre el pasado del coche.
Grupos de concesionarios y software
Incorpore los datos de mantenimiento al peritaje, al inventario o al DMS para que nadie tenga que adivinar en el momento de la tasación.
Tasación, financiación y seguros
Un historial documentado influye de verdad en el valor residual y en el riesgo. Consúltelo justo cuando se toma la decisión.
Flotas, renting y alquiler
Concilie lo que registró la red del fabricante con su propio libro de mantenimiento antes de dar de baja un vehículo.
Qué se devuelve
Un cuerpo JSON predecible que puede representar directamente. Sin scraping, sin extraer texto de archivos PDF y sin ninguna marca nuestra en los datos.
- Fecha de cada intervención registrada
- Kilometraje anotado en ese momento, con su unidad
- El taller o concesionario que realizó el trabajo
- Tipo de mantenimiento y las operaciones registradas
- Identidad del vehículo: marca, modelo, año, combustible y motor
POST /api/v1/lookup
Authorization: Bearer fsh_live_…
{ "vin": "WBA8E9G50GNT12345" }La petición: basta con enviar el VIN
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Serie 3",
"yearOfManufacture": 2018,
"fuelType": "Diésel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Madrid Norte",
"serviceType": "Cambio de aceite",
"serviceActions": [
"Aceite de motor y filtro",
"Filtro de habitáculo"
]
}
],
"hasServiceHistory": true
}
}
Respuesta de ejemplo — abreviada
Cómo funciona una integración
- 1
Cuéntenos qué necesita
Volumen, mercados y cómo piensa mostrar los datos. Le enviamos una tarifa y confirmamos la cobertura de las marcas con las que realmente trabaja.
- 2
Emitimos sus credenciales
Una clave y un secreto de firma asociados a su cuenta. Si lo desea, limitados a sus direcciones de salida, con un límite ajustado a su volumen.
- 3
Consulte, o deje que le avisemos
Haga la petición y espere la respuesta, o envíe un trabajo y reciba una llamada firmada cuando el registro esté listo. Ambas opciones están disponibles desde el primer día.
La cobertura, contada con honestidad
Cobertura es lo que se puede recuperar, no con qué frecuencia se recupera. Ambas cifras le importan, así que esta es la distinción con la que trabajamos.
Hay 44 marcas cubiertas desde el año modelo 2012 en mercados europeos. Los vehículos anteriores a veces devuelven registros, pero nunca lo prometemos.
La profundidad varía según el fabricante. Algunos devuelven una descripción completa del trabajo y el taller; otros solo la intervención y el kilometraje. Le diremos qué ocurre con su combinación de marcas antes de que se comprometa.
Con qué frecuencia aparece un registro depende de los vehículos que consulte, no de la fuente. Un stock de furgonetas ex-flota mantenidas fuera de la red oficial devuelve mucho menos que uno de coches de particular.
Qué significa realmente un hueco
Que no haya registro significa que la red del fabricante no tiene nada de ese vehículo, no que el vehículo no se haya mantenido. El trabajo de un taller independiente es invisible para estos sistemas. El texto que muestre a sus propios usuarios debería reflejarlo, y le ayudamos a redactarlo.
Preparada para tráfico real
Autenticación por token
Credenciales Bearer, cifradas en reposo y revocables clave por clave.
Llamadas firmadas
Cada llamada de vuelta lleva una firma HMAC-SHA256 y una marca de tiempo, y se reintenta según un calendario fijo hasta recibir confirmación.
Reintentos seguros
Envíe una clave de idempotencia y una petición repetida devolverá la respuesta original. Nunca se cobra dos veces.
Lista de direcciones permitidas
Si lo desea, una clave solo funciona desde sus propios rangos de salida, de modo que una credencial filtrada resulta inútil en otro sitio.
Límites ajustados a usted
El valor por defecto es deliberadamente bajo. El suyo se eleva hasta el volumen contratado.
Especificación legible por máquina
Una descripción OpenAPI 3.1, para que su equipo genere un cliente en lugar de escribirlo a mano.
Cómo funciona el precio
Sencillo y por volumen. Le damos una tarifa en cuanto sabemos qué consulta y en qué cantidad.
- Se paga por resultado, no por petición
- Una consulta que no encuentra nada no se cobra
- La tarifa baja a medida que sube el volumen mensual
- Facturación mensual, sin permanencia
No publicamos tarifas porque el precio adecuado depende del volumen, del mercado y de la combinación de marcas. Indíquenos esas tres cosas y tendrá una cifra enseguida.
Solicitar tarifaHablemos del acceso a la API
Cuéntenos brevemente qué integración tiene en mente y le responderemos con detalles de cobertura y una tarifa. Leemos personalmente cada mensaje.
Preguntas frecuentes
¿Los datos llevan alguna marca?
No. La respuesta contiene datos del vehículo y nada nuestro: ni logotipo, ni nombre, ni enlace de vuelta. Son suyos para mostrarlos como propios.
¿Cuánto tarda una consulta?
El registro se obtiene en directo de la red del fabricante, así que cuente con decenas de segundos y no con milisegundos. Para volúmenes altos se envía un trabajo y le avisamos al terminar, de modo que su aplicación no espera.
¿Podemos almacenar lo que obtenemos?
La conservación y la reutilización se acuerdan por contrato, no se dan por supuestas. Importa sobre todo si vuelve a publicar el mismo vehículo varias veces; dejaremos claro qué está permitido antes de firmar.
¿Qué pasa si una consulta no encuentra nada?
Recibe un resultado vacío inequívoco y no se factura. Un vacío real y un fallo del proveedor se comunican de forma distinta, así que nunca cobrará a sus usuarios por una incidencia nuestra.
¿Podemos probarla antes?
Sí. Normalmente empezamos con una prueba de concepto de pago reducida, descontada de su primera factura, para que mida la tasa de acierto sobre su propio stock y no sobre el nuestro.
¿Firman un contrato de encargo de tratamiento?
Sí. Los contratos de empresa cubren protección de datos, uso permitido y compromisos de soporte. Si lo prefiere, trabajamos sobre su propia documentación.
¿Listo para ver los datos?
Envíenos su volumen y los mercados en los que opera. Recibirá detalles de cobertura y una tarifa, no una secuencia comercial.
Solicitar acceso a la API