У вас есть номер. Вам нужны марка, модель, вариант, комплектация и восемь картинок. Преобразование одного в другое — это та часть, которую никто не хочет делать, поэтому мы её и сделали.
Они приходят в стоковом фиде, в документе о регистрации, в таблице от лизинговой компании.
GET /vin/WVWZZZ1KZAW000000
Кто-то ввёл его в форму обмена, или прочитал с автомобиля, стоящего перед ним.
GET /plate/MVI2024?country=DE
Человек ввёл его в поисковую строку, с пробелами и прозвищем, которые он использовал.
GET /api/search?q=fiat%20500%202020
Примеры ответов, сокращённые. Идентификаторы — это заполнители, автомобили и цвета рядом с ними — это реальный каталогный вывод.
Три вещи, в одном запросе. Средняя — это причина, по которой это сложнее, чем кажется, и причина, по которой ответ говорит вам, насколько он уверен.
Номер VIN становится маркой, моделью, годом, кузовом, двигателем и коробкой передач. Номерной знак становится тем же, плюс номер VIN за ним и цвет, в который была зарегистрирована машина. Свободный текст становится тем каталоговым вхождением, к которому шли слова.
Расшифрованное транспортное средство сравнивается с каталогом, и ответ показывает, насколько хорошо оно подходит. Это поле существует, потому что близкий результат — это нормальный исход в этом бизнесе, и вы должны быть тем, кто решает, что с этим делать.
В том же ответе содержится один подписанный URL изображения на вид, который позволяет ваш план. Нет второго вызова, нет вашей собственной таблицы сопоставления, нет ночной работы, которая согласовывает две системы.
Поиск по номеру знает цвет, в который была зарегистрирована машина, и передаёт его в запрос на изображение. Так что страница trade-in показывает автомобиль, который клиент узнает на парковке, а не какой-то общий серебристый заменитель, который заставляет его сомневаться, правильный ли у вас автомобиль вообще.
Когда зарегистрированный цвет отсутствует в каталоге для данной модели, используется стандартное покрытие, а vehicle.color указывает, что было использовано на самом деле. Это поле позволяет странице печатать "цвет может отличаться" только тогда, когда это действительно так, вместо того, чтобы оставлять это предупреждение под каждой машиной навсегда и приучать людей не доверять картинкам.
После поиска совпавший автомобиль — это обычная запись каталога. Если вы хотите его в другом цвете, или во всех восьми ракурсах, или вырезанным для своей сцены, это тот же автомобиль и те же конечные точки, что и всё остальное на этом сайте.
Сопоставление реального автомобиля с каталогной записью не всегда однозначно: рестайлинг, специфичные для рынка комплектации, вариант, который продавался одиннадцать месяцев. Вместо того, чтобы скрывать это, ответ оценивает его.
Великобритания, большая часть Европы, США и ряд других рынков. Регистрации повторяются через границы, поэтому передавайте страну, если вы её знаете. Без этого поиск должен угадывать, и угадывание — это как британский номер становится голландским фургоном.
Вы получаете matched: false и отсутствие изображений, а не что-то похожее, выданное за результат. Неправильная машина в списке обходится дороже, чем пустое место.
Расшифровка происходит из данных о транспортных средствах, которые мы лицензируем, из того же источника, на основе которого построен каталог. Вот почему условия лицензии можно записать: здесь ничего не было скопировано с чужого сайта.
Нет, это дополнительные функции. Ваш ключ либо имеет их, либо нет, и GET /api/me сообщает, какие. Спросите нас, и мы их включим.
Да. Поиск заполняет зарегистрированный цвет, так как это обычно то, что вам нужно, но само транспортное средство после этого становится обычной записью в каталоге. Запрашивайте его в любом цвете, который поддерживается моделью.
Реальные данные из вашего собственного склада или ваших собственных форм обмена. Мы их обрабатываем и отправляем обратно то, что вышло, включая те, что не совпали, потому что эта цифра расскажет вам больше о том, подходит ли это вам, чем те, что совпали.
