Recherche

Recherchez un véhicule réel par numéro d'immatriculation (Bêta)

GET/plate/{plate}

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

Transformez un numéro d'immatriculation en données de véhicule et en images studio de cette voiture exacte, y compris sa vraie couleur de peinture lorsque nous avons une correspondance.

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

Ce que vous recevez en retour.

Le véhicule derrière la plaque: marque, modèle, année, carrosserie, couleur, moteur, transmission, et son VIN.
Un bloc vehicle avec la voiture du catalogue correspondante et une URL d'image signée par vue que votre plan autorise.

La couleur est appliquée automatiquement. Si la voiture est enregistrée comme blanche, les images reviennent en blanc. Les couleurs que nous ne proposons pas (par exemple, argent, beige) reviennent à la finition standard, vehicle.color indique toujours ce qui a été utilisé.

La couverture varie selon les pays. Le Royaume-Uni, la plupart de l'Europe, les États-Unis et un certain nombre d'autres marchés sont pris en charge; certains pays restreignent les recherches d'immatriculation par la loi. Les espaces et les tirets sur la plaque sont ignorés.

Paramètres de chemin

Nom	Type	Description
`plate` obligatoire	chaîne	Numéro d'immatriculation. Les espaces et les tirets sont ignorés

Paramètres de requête.

Nom	Type	Description
`country`	chaîne	Pays d'immatriculation. Par défaut, le Royaume-Uni.

Demande

curl "https://api.vehicleimagery.com/plate/plate?country=uk" \
  -H "x-api-key: YOUR_API_KEY"

200 · Véhicule derrière la plaque plus la voiture du catalogue correspondante et ses images.

{
  "plate": "AB12CDE",
  "make": "Vauxhall",
  "model": "Astra SRI Turbo",
  "year": 2017,
  "body": "Hatchback",
  "colour": "White",
  "vin": "W0LBF6EC2HG138041",
  "engine": {
    "displacement_ccm": 1399,
    "fuel": "Petrol",
    "code": "B 14 XFT"
  },
  "transmission": "Manual",
  "doors": 5,
  "seats": 5,
  "vehicle": {
    "matched": true,
    "confidence": "medium",
    "id": 402118773,
    "brand": "Vauxhall",
    "model": "Astra_Mk7",
    "year": 2015,
    "variant": "Basis",
    "trim": "base",
    "color": "white",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · Le numéro d'immatriculation n'est pas utilisable. Rien n'est facturé.

{
  "error": "Invalid registration number."
}

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

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

404 · Aucun véhicule trouvé pour ce numéro d'immatriculation.

{
  "error": "No data found for this registration number.",
  "plate": "AB12CDE"
}

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

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