Поиск

Найти реальный автомобиль по номеру регистрации

GET/plate/{plate}

Преобразуйте номер регистрации в данные о транспортном средстве и студийные изображения этого конкретного автомобиля — включая его настоящий цвет краски, если у нас есть совпадение.

Дополнение — должно быть включено для вашего ключа. Проверьте features.plate в /api/me; без него конечная точка возвращает 403.

Что вы получаете обратно

Транспортное средство за номерным знаком — марка, модель, год, кузов, цвет, двигатель, трансмиссия и его VIN.
Блок vehicle с совпадающим автомобилем из каталога и одной подписанной ссылкой на изображение на вид, который разрешен вашим планом.

Цвет применяется автоматически. Если автомобиль зарегистрирован как белый, изображения возвращаются в белом цвете. Цвета, которых у нас нет (например, серебристый, бежевый), отображаются в стандартной отделке — vehicle.color всегда указывает, что было фактически использовано.

Покрытие варьируется в зависимости от страны. Поддерживаются Великобритания, большая часть Европы, США и ряд других рынков; некоторые страны по закону ограничивают запросы на регистрацию. Пробелы и дефисы в номере игнорируются.

Параметры пути

Название	Тип	Описание
`plate` обязательно	строка	Номер регистрации. Пробелы и тире игнорируются.

Параметры запроса

Название	Тип	Описание
`country`	строка	Страна регистрации. По умолчанию — Великобритания.

Запрос

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

200 · Транспортное средство за номером плюс сопоставленный каталогный автомобиль и его изображения.

{
  "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 · Номер регистрации не пригоден для использования. Ничего не взимается.

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

403 · Дополнение с номером не активировано для вашего ключа.

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

404 · Автомобиль по этому регистрационному номеру не найден.

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

502 · Поиск временно недоступен — повторите попытку через несколько минут. Ничего не списывается.

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