Recherche

Recherchez un véhicule réel par VIN (Bêta)

GET/vin/{vin}

> Bêta. Cet endpoint est en ligne et utilisable, mais encore en évolution: les champs de réponse peuvent changer, et la couverture de décodage et la correspondance du catalogue sont en amélioration. Les retours sont les bienvenus. Ne construisez rien de mission-critique sur la forme exacte de la réponse pour l'instant.

Décodez un VIN de 17 caractères en données de véhicule et obtenez des images studio de la voiture correspondante en un seul appel.

Add-on: doit être activé pour votre clé. Vérifiez features.vin dans /api/me; sans cela, l'endpoint renvoie 403.

Ce que vous recevez en retour.

Le véhicule décodé, la marque, le modèle, l'année, la finition, le type de carrosserie, le moteur, la transmission, la transmission.
Un bloc vehicle avec la voiture la plus proche de notre catalogue et une URL d'image signée par vue que votre plan autorise.

Correspondance automatique: la marque/modèle/année/carrosserie décodée est mappée sur notre catalogue, sélectionnant la génération qui couvre l'année du véhicule. Lisez vehicle.confidence pour voir à quel point la correspondance est proche, et vehicle.matched: false lorsqu'il n'existe rien de convenable. Les données décodées sont toujours retournées dans ce cas.

Les VIN invalides sont rejetés avec 400 avant tout frais. Un VIN qui ne peut pas être décodé renvoie 404.

Paramètres de chemin

Nom	Type	Description
`vin` obligatoire	chaîne	Numéro d'identification du véhicule de 17 caractères (les lettres I, O et Q ne sont jamais utilisées).

Demande

curl "https://api.vehicleimagery.com/vin/vin" \
  -H "x-api-key: YOUR_API_KEY"

200 · Véhicule décodé plus la voiture du catalogue correspondante et ses images.

{
  "vin": "WBA8E9G50GNT47251",
  "make": "BMW",
  "model": "3 Series",
  "year": 2016,
  "trim": "328i",
  "body": "Sedan",
  "engine": {
    "name": "328i",
    "cylinders": 4,
    "displacement_ccm": 1997,
    "horsepower": 240,
    "fuel": "premium unleaded",
    "configuration": "inline"
  },
  "transmission": "AUTOMATIC",
  "drivetrain": "rear wheel drive",
  "doors": "4",
  "vehicle": {
    "matched": true,
    "confidence": "high",
    "id": 993477403,
    "brand": "BMW",
    "model": "3",
    "year": 2012,
    "variant": "Basis",
    "trim": "base",
    "color": "default",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · Le VIN n'est pas un VIN valide de 17 caractères. Rien n'est facturé.

{
  "error": "Invalid VIN: expected 17 characters (letters I, O, Q are not used)."
}

403 · L'add-on VIN n'est pas activé pour votre clé.

{
  "error": "The vin add-on is not enabled for your API key."
}

404 · Aucune donnée n'a pu être trouvée pour ce VIN.

{
  "error": "No data found for this VIN.",
  "vin": "WBA8E9G50GNT47251"
}

502 · Recherche temporairement indisponible, réessayez plus tard. Rien n'est facturé.

{
  "error": "VIN lookup temporarily unavailable."
}