FrançaisRapports d’historique du véhicule
Carfax et AutoCheck par VIN, à la demande.
Vérifiez gratuitement combien d’entrées chaque fournisseur a pour un VIN, puis demandez le rapport complet seulement s’il en vaut la peine. Vous recevez un lien vers le rapport HTML, un PDF en option et votre solde après le débit.
GET /reports/{type}/{vin}- html
- base64
- balance_after
Comment ça marche
- 1
Vérifier les entrées (gratuit)
Appelez
/reports/check-records/{vin}.L’appel renvoie le nombre d’entrées Carfax et AutoCheck et le nom du véhicule. Rien n’est facturé. - 2
Demander le rapport (payant)
Appelez
/reports/{type}/{vin}avec type carfax ou autocheck. Le prix d’un rapport est débité de votre solde en USD. - 3
Utiliser le résultat
Ouvrez le lien html, ajoutez pdf=1 si vous avez besoin d’un fichier PDF, et lisez
balance_afterpour connaître le solde restant.
Vérifier un VIN maintenant
Gratuit : seules les entrées sont comptées.
GET /reports/check-records/{vin}VIN de test gratuit
Utilisez ce VIN pour essayer les deux étapes. Ses rapports sont gratuits.
Facturation
- Les rapports sont payés sur un seul solde en USD, partagé avec Pay per VIN.
/reports/balancel’affiche. - check-records, balance et my-history sont gratuits.
- Avec days=N, un rapport déjà généré au cours des N derniers jours est renvoyé au lieu d’en créer un nouveau.
- Quand le solde est insuffisant, l’API répond 402 avec insufficient funds et ne facture rien.
- Quand un fournisseur n’a pas d’historique pour le VIN, l’API répond 400 avec records not found for this vin number et ne facture rien.
Référence API
Bon à savoir
- Le VIN doit faire exactement 17 caractères ; sinon, l’API renvoie 400.
- pdf=1 peut prendre de 40 à 60 secondes. Prévoyez un long délai d’attente et n’envoyez jamais deux fois la même requête : un doublon reçoit 409 generation already in progress, avec Retry-After.
- base64 contient le corps chiffré du rapport. Ajoutez
exclude_base_64=1si vous n’avez besoin que des liens. - Les valeurs html et pdf sont des liens vers des fichiers. Enregistrez le lien ou le fichier de votre côté.