Le carnet d'entretien constructeur, en API
Un seul appel authentifié renvoie l'historique d'entretien officiel d'un véhicule en JSON structuré : dates, kilométrages, atelier ayant réalisé l'intervention et nature des travaux. À afficher dans vos annonces, vos estimations ou votre parcours de reprise.
L'accès se met en place directement avec nous : indiquez-nous votre volume et votre usage, et vous recevrez un tarif.
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Série 3",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Paris Ouest",
"serviceType": "Vidange",
"serviceActions": [
"Huile moteur et filtre",
"Filtre d'habitacle"
]
}
],
"hasServiceHistory": true
}
}
À qui elle s'adresse
Si l'historique d'entretien d'un véhicule pèse sur la décision de vos utilisateurs, sa place est dans votre produit, pas dans un onglet séparé.
Places de marché et remarketing
Affichez le carnet d'entretien dans l'annonce elle-même. Les acheteurs enchérissent avec plus de confiance et les vendeurs répondent à moins de questions sur le passé du véhicule.
Groupes de distribution et éditeurs
Intégrez les données d'entretien à l'expertise, à la gestion de stock ou au DMS, pour que personne n'avance à l'aveugle au moment de la reprise.
Cotation, financement et assurance
Un entretien documenté pèse réellement sur la valeur résiduelle et sur le risque. Consultez-le au moment précis où la décision se prend.
Flotte, location longue durée et loueurs
Rapprochez ce qu'a enregistré le réseau constructeur de votre propre carnet d'entretien avant la sortie de parc d'un véhicule.
Ce que vous recevez
Un corps JSON prévisible, directement exploitable à l'affichage. Sans extraction sauvage, sans lecture de fichiers PDF et sans la moindre marque de notre part dans les données.
- Date de chaque intervention enregistrée
- Kilométrage relevé à cette date, avec son unité
- L'atelier ou la concession ayant réalisé les travaux
- Type d'entretien et opérations enregistrées
- Identité du véhicule : marque, modèle, année, carburant et moteur
POST /api/v1/lookup
Authorization: Bearer fsh_live_…
{ "vin": "WBA8E9G50GNT12345" }La requête : vous n’envoyez que le VIN
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Série 3",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Paris Ouest",
"serviceType": "Vidange",
"serviceActions": [
"Huile moteur et filtre",
"Filtre d'habitacle"
]
}
],
"hasServiceHistory": true
}
}
Exemple de réponse — abrégé
Comment se déroule une intégration
- 1
Dites-nous ce dont vous avez besoin
Volume, marchés et mode d'affichage envisagé. Nous revenons vers vous avec un tarif et confirmons la couverture sur les marques que vous traitez réellement.
- 2
Nous émettons vos identifiants
Une clé et un secret de signature rattachés à votre compte. Si vous le souhaitez, restreints à vos adresses de sortie, avec une limite calée sur votre volume.
- 3
Vous appelez, ou nous vous rappelons
Envoyez la requête et attendez la réponse, ou déposez une tâche et recevez un rappel signé dès que le relevé est prêt. Les deux modes sont disponibles dès le premier jour.
La couverture, expliquée honnêtement
La couverture désigne ce qui peut être récupéré, pas la fréquence à laquelle une réponse arrive. Les deux comptent pour vous : voici donc la distinction sur laquelle nous travaillons.
44 marques sont couvertes à partir du millésime 2012, sur les marchés européens. Les véhicules antérieurs renvoient parfois des relevés, mais nous ne le promettons jamais.
Le niveau de détail varie selon le constructeur. Certains renvoient une description complète des travaux et l'atelier, d'autres uniquement l'intervention et le kilométrage. Nous vous précisons ce qu'il en est pour vos marques avant tout engagement.
La fréquence des relevés dépend des véhicules que vous interrogez, pas de la source. Un parc d'utilitaires d'anciennes flottes entretenus hors réseau renvoie bien moins qu'un parc de véhicules de particuliers.
Ce qu'un trou signifie réellement
Aucun relevé trouvé signifie que le réseau du constructeur ne détient rien sur ce véhicule, et non que le véhicule n'a pas été entretenu. Les interventions d'un garage indépendant sont invisibles pour ces systèmes. La formulation que vous présentez à vos propres utilisateurs doit le refléter, et nous vous aidons à la rédiger.
Conçue pour du trafic de production
Authentification par jeton
Identifiants Bearer, chiffrés au repos et révocables clé par clé.
Rappels signés
Chaque rappel porte une signature HMAC-SHA256 et un horodatage, et il est réémis selon un calendrier fixe jusqu'à confirmation.
Reprises sans risque
Envoyez une clé d'idempotence et une requête répétée renvoie la réponse d'origine. Jamais facturée deux fois.
Liste d'adresses autorisées
Une clé peut n'être valable que depuis vos propres plages de sortie, de sorte qu'un identifiant divulgué reste inutilisable ailleurs.
Des limites calées sur vous
La valeur par défaut est volontairement basse. La vôtre est relevée au volume contractualisé.
Spécification exploitable par machine
Une description OpenAPI 3.1, pour que votre équipe génère un client au lieu de l'écrire à la main.
Comment fonctionne la tarification
Simple et fonction du volume. Nous chiffrons dès que nous savons ce que vous interrogez et en quelle quantité.
- Vous payez au résultat, pas à la requête
- Une recherche infructueuse n'est pas facturée
- Le tarif baisse à mesure que le volume mensuel augmente
- Facturation mensuelle, sans durée d'engagement
Nous ne publions pas de grille tarifaire, car le bon tarif dépend du volume, du marché et de la répartition des marques. Communiquez-nous ces trois éléments et vous aurez un chiffre rapidement.
Demander un tarifParlons de votre accès API
Décrivez brièvement l'intégration envisagée et nous vous répondrons avec le détail de la couverture et un tarif. Nous lisons nous-mêmes chaque message.
Questions fréquentes
Les données portent-elles une marque ?
Non. La réponse contient des données véhicule et rien de nous : ni logo, ni nom, ni lien retour. Elles sont à vous, à afficher comme les vôtres.
Combien de temps prend une requête ?
Le relevé est récupéré en direct auprès du réseau constructeur : comptez donc des dizaines de secondes, pas des millisecondes. Pour des volumes importants, vous déposez une tâche et nous vous rappelons une fois prête, sans que votre application ait à attendre.
Pouvons-nous conserver les données obtenues ?
La conservation et le réaffichage sont définis par contrat, jamais présumés. Le sujet compte surtout si vous remettez le même véhicule en ligne plusieurs fois ; nous précisons ce qui est permis avant signature.
Que se passe-t-il si une requête ne trouve rien ?
Vous obtenez un résultat vide sans ambiguïté, et il n'est pas facturé. Un vide réel et une défaillance du fournisseur sont signalés différemment : vous ne facturerez jamais un incident de notre côté à vos propres utilisateurs.
Pouvons-nous tester au préalable ?
Oui. Nous démarrons généralement par une petite preuve de concept payante, déduite de votre première facture, afin que vous mesuriez le taux de retour sur votre propre parc et non sur le nôtre.
Signez-vous un contrat de sous-traitance de données ?
Oui. Les contrats entreprise couvrent la protection des données, l'affichage autorisé et les engagements de support. Nous pouvons aussi partir de vos propres documents.
Prêt à examiner les données ?
Communiquez-nous votre volume et vos marchés. Vous recevrez le détail de la couverture et un tarif, pas une séquence commerciale.
Demander un accès API