Vous savez déjà de quelle voiture il s'agit

Vous avez un numéro. Ce dont vous avez besoin, c'est une marque, un modèle, une variante, une finition et huit images. Transformer l'un en l'autre est la partie que personne ne veut construire, donc c'est la partie que nous avons construite.

Elle arrive dans un flux de stock, sur un document d'immatriculation, dans une feuille de calcul de la société de leasing.

GET /vin/WVWZZZ1KZAW000000

{"vin": "WVWZZZ1KZAW000000","fabricant": "Volkswagen","modèle": "Golf","année": 2024,"carrosserie": "Hatchback","transmission": "MANUELLE","véhicule": {"correspondant": vrai,"confiance": "haute","marque": "Volkswagen","couleur": "Acapulco Blue Metallic","images": { "avant_gauche": "https://cdn…", … }}}
La Volkswagen Golf correspondante à un VIN

Exemples de réponses, raccourcies. Les identifiants sont des placeholders, les véhicules et les couleurs à côté sont des sorties réelles du catalogue.

Ce qui se passe entre le numéro et l'image

Trois choses, en une seule demande. La deuxième est la raison pour laquelle c'est plus difficile que cela ne le semble, et la raison pour laquelle la réponse vous indique à quel point elle est sûre.

01

Décoder

Un VIN devient une marque, un modèle, une année, une carrosserie, un moteur et une boîte de vitesses. Une plaque devient la même chose, plus le VIN derrière elle et la couleur dans laquelle la voiture a été immatriculée. Le texte libre devient l'entrée de catalogue que les mots visaient.

02

Correspondance

Le véhicule décodé est comparé au catalogue, et la réponse indique à quel point il correspond. Ce champ existe parce qu'un résultat proche est un résultat normal dans ce métier, et c'est à vous de décider quoi en faire.

03

Livrer

La même réponse contient une URL d'image signée par vue que votre plan autorise. Pas de second appel, pas de table de mappage personnelle, pas de travail de nuit qui réconcilie deux systèmes.

Une voiture blanche revient blanche

Une recherche de plaque connaît la couleur dans laquelle le véhicule a été immatriculé, et elle transmet cette information à la demande d'image. Ainsi, une page de reprise montre la voiture que le client reconnaîtra sur le parking, et non un substitut argenté générique qui le fait se demander si vous avez le bon véhicule.

Lorsque la couleur enregistrée ne figure pas dans le catalogue pour ce modèle, elle revient à la finition standard et vehicle.color indique ce qui a été utilisé. Ce champ est la raison pour laquelle une page peut imprimer "la couleur affichée peut différer" uniquement lorsque c'est vrai, au lieu de laisser cet avertissement sous chaque voiture pour toujours et d'entraîner les gens à ne pas faire confiance aux images.

Après la recherche, le véhicule correspondant est une entrée de catalogue ordinaire. Si vous souhaitez la voir dans une autre peinture, ou sous tous les huit angles, ou découpée pour votre propre scène, il s'agit du même véhicule et des mêmes points de terminaison que tout le reste sur ce site.

La réponse indique à quel point elle est sûre

Associer une voiture réelle à une entrée de catalogue n'est pas toujours simple: restylages, finitions spécifiques au marché, une variante vendue pendant onze mois. Plutôt que de le cacher, la réponse la note.

"haute"L'entrée du catalogue est le véhicule. Publiez-la.
"moyenne"Bon modèle, mais quelque chose en dessous est incertain: une variante, une année de restylage. Parfait pour une vignette de liste, un coup d'œil avant une image principale.
"faible"La chose la plus proche que nous ayons. Considérez-la comme une suggestion, pas une réponse, et envisagez de ne rien afficher à la place.

Avant de demander

Quels pays la recherche de plaque couvre-t-elle?

Le Royaume-Uni, la majeure partie de l'Europe, les États-Unis et un certain nombre d'autres marchés. Les immatriculations se répètent à travers les frontières, donc passez le pays lorsque vous le connaissez. Sans cela, la recherche doit deviner, et deviner c'est comment une plaque britannique devient une fourgonnette hollandaise.

Que se passe-t-il lorsqu'il n'y a pas de correspondance?

Vous obtenez matched: false et aucune image, plutôt que la chose la plus proche déguisée en résultat. Une mauvaise voiture sur une liste coûte plus cher qu'un emplacement vide.

Les données décodées vous appartiennent ou sont-elles celles d'un tiers?

Le décodage provient des données de véhicules que nous licenciions, la même source sur laquelle le catalogue est construit. C'est aussi pourquoi les conditions de licence peuvent être écrites: rien ici n'a été récupéré sur le site de quelqu'un d'autre.

Le VIN et la plaque font-ils partie de chaque plan?

Non, ce sont des options. Votre clé les a ou ne les a pas, et GET /api/me vous dit lesquelles. Demandez-nous et nous les activons.

Puis-je rechercher une voiture et changer la couleur quand même?

Oui. La recherche remplit la couleur enregistrée car c'est généralement ce que vous voulez, mais le véhicule auquel elle correspond est ensuite une entrée de catalogue ordinaire. Demandez-le dans n'importe quelle peinture que le modèle porte.

Envoyez-nous vingt plaques

Des vraies, issues de votre propre stock ou de vos propres formulaires de reprise. Nous les traitons et renvoyons ce qui en est sorti, y compris celles qui n'ont pas correspondu, car ce nombre vous en dit plus sur l'efficacité de ce service pour vous que celles qui ont correspondu.