Инструкция: интеграция автомобилей
Загрузка и обновление склада автомобилей по API
МДанная инструкция предназначена для загрузки данных по автомобилям д отпилера на вки:трину POST-запросLegoCar
Заголовки запроса:
|
POST https://*host*/api/v1/cars/import/ Authorization: *token* Car-Type: *type* Content-Type: application/json |
- *host* - адрес витрины с указанием протокола, например your-domain.ru;
- *token*- токен авторизации, передаваемая вместе с данной инструкцией,
- *type* - тип автомобилей которые будут загружаться. Передается вместе с инструкцией, например new;
Используется защищенное подключение.
Тело запроса (не путать с параметрами запроса):
|
[ { "vin":*VIN*, //Обязательное поле "brand": *BRAND*, //Обязательное поле "model": *MODEL*, //Обязательное поле "dealer": *DEALER_ID*, "run": *RUN*, "drive": *DRIVE*, "year": *YEAR*, "color": *COLOR*, "engine_power": *POWER*, "price": *PRICE*,//Обязательное поле "special": *SPECIAL*,//Обязательное поле "body_type": *BODY_TYPE*, "equipment": *equipment*, "engine_type": *engine_type*, "door_count": *door_count*, "description": *description*, "gearbox": *gearbox*, "engine_volume": *engine_volume*, "images":[ *IMAGES* ], "modifiers":[ *MODIFIERS* ], }, { "vin":"MXC1PAB80NK099933" //Обязательное поле "brand": "BMM", //Обязательное поле "model": "X99", //Обязательное поле "dealer": 1, "run": 0, "drive": "Передний", "year": 2010, "color": "Белый", "engine_power": 123, "price": 1000000,//Обязательное поле "special": 1000000,//Обязательное поле "body_type": "Седан", "equipment": "Ультиматный", "engine_type": "Бензин", "door_count": 5, "description": "Описание описание", "gearbox": "Автомат", "engine_volume": "1.8", "images":[ "https://www.car-info.com/uploads/120.jpg", "https://www.car-info.com/uploads/122.jpg" ], "modifiers":[ { "code": "credit", "value": "50000" }, { "code": "trade-in", "value": "50000" }, { "code": "max_disc", "value": "50000" }, { "code": "kasko", "value": "50000" } ] } ] |
где
- *vin* - VIN номер автомобиля (строка), / обязательное поле
- *brand* - Название бренда (стока), / обязательное поле
- *model* - Название модели(стока), / обязательное поле
- *dealer_id* - ID дилерского центра. Получается в ЛК, либо передается вместе с интеграцией (число),
- *run* - Пробег автомобиля (число),
- *drive* - Тип привода автомобиля (строка),
- *year* - Год выпуска автомобиля (число),
- *color* - Цвет автомобиля (строка),
- *engine_power* - Мощность автомобиля, в л.с. только цифры (число),
- *price* - РРЦ автомобиля, число без форматирования (число), / обязательное поле
- *special* - Спеццена автомобиля [Если её нету, нужно передать сюда price], число без форматирования (число), / обязательное поле
- *body_type* - Тип кузова автомобиля (строка),
- *equipment* -Название комплектации автомобиля (строка),
- *engine_type* -Тип топлива двигателя (строка),
- *door_count* - Кол-во дверей. (число),
- *description* -Описание автомобиля (строка),
- *gearbox* - Тип коробки (строка),
- *engine_volume* - Объем двигателя в литрах. через точку 1.6 (число с плавающей точкой),
- *images* - ссылки на фотографии (массив строк) - Указываются ссылки с https сертификатом и ответом images [ссылки на FTP/yandex images не подходят]
- *modifiers* - массив модификаторов где trade-in - скидка за Trade-In/max_disc - Максимальная скидка/credit - скидка за Кредит/kasko - Скидка за страховки [Все скидки вычитаются от special цены автомобиля]
Успешная выгрузка:
После успешной выгрузки вы получите ответ:
|
{ "total": 1, "success": 1, "error": 0 } |
Не успешная выгрузка:
После не успешной выгрузки вы получите ответ:
|
{ "total": 3, "success": 2, "error": 1, "error_info": [ { "object_info": { "vin": "MXC1PAB80NK099933" }, "error": { "power": [ "Введите целое число." ] }, "index": 0 } ] } |