Поиск
Ресурсы
Ссылка | Тип запроса | Описание |
---|---|---|
/v1/search/name | GET | Поиск по наименованию и артикулу Восхода |
/v1/search/cross | GET | Поиск по кроссу |
GET /v1/search/name
Поиск по наименованию и артикулу Восхода
Входные параметры
Параметр | Тип | Описание |
---|---|---|
page | Целое | Указание страницы разбиения. По-умолчанию, 1 |
q | Строка | Поиск по заданному слову или фрагменту. Обязательный параметр |
a | Целое |
Наличие товара: 0 — нет в наличии 1 — имеющийся в продаже не задано — отображается все |
s | Целое |
Сортировка по: 1 — наименованию (по возрастанию) 2 — наименованию (по убыванию) 3 — сроку доставки (по возрастанию) 4 — сроку доставки (по убыванию) 5 — остаткам (по возрастанию) 6 — остаткам (по убыванию) 7 — цене (по возрастанию) 8 — цене (по убыванию) |
b | Строка | Фильтр по бренду |
d | Строка | Фильтр по отделу |
j | Целое |
Режим поиска. Совпадение слов: 1 — любое (наличие хотя бы одного из слов поиска в названии товара/бренде/артикуле) 2 — строгое (ищутся товары в названии/бренде/артикуле которых присутствуют указанные в поиске слова) 3 — поиск осуществляется ТОЛЬКО по бренду/артикулу 0 или отсутствует — поиск по части слов (по-умочанию) |
Ответ сервера
Возвращаются объекты page
, brands
, departments
, items
или объект errors
Объект page
имеет струкруту:
Параметр | Тип | Описание |
---|---|---|
current | Целое | Текущая страница. По-умолчанию, 1 |
next | Целое | Следующая страница |
prev | Целое | Предыдущая страница |
pages | Целое | Всего страниц разбиения |
items | Целое | Количество объектов |
Объект brands
является массивом строк.
Объект departments
является массивом строк.
Объект items
имеет струкруту:
Параметр | Тип | Описание |
---|---|---|
images | Массив | Список картинок |
p_code | Строка | Код поставщика. По-умолчанию, "VNY6" |
mog | Строка | Артикул номенклатуры в базе Восхода |
oem_num | Строка | Артикул производителя |
oem_brand | Строка | Бренд производителя |
name | Строка | Название номенклатуры |
shipment | Целое | Кратность покупки |
delivery | Целое | Срок доставки |
count | Целое | Общее количество товара на всех складах |
count_chel | Целое | Количество товара на складе в Челябинске (всего) |
count_chel_st | Целое | Количество товара на складе в Челябинске (Сталеваров) |
count_chel_cin | Целое | Количество товара на складе в Челябинске (Цинковая) |
count_ekb | Целое | Количество товара на складе в Екатеринбурге |
count_magn | Целое | Количество товара на складе в Магнитогорске |
count_surgut | Целое | Количество товара на складе в Сургуте |
unit_code | Целое | Код единицы измерения |
unit | Целое | Единица измерения |
price | Вещественное | Стоимость товара с учетом количества |
va_catalog_id | Строка | Идентификатор каталога в 1С |
va_item_id | Строка | Идентификатор товара в 1С |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/name.json?q=колпаки
Ответ JSON
{ "response": { "page":{ "current":1, "next":2, "prev":null, "pages":9, "items":433 }, "brands":[ "AIRLINE", "ATY", "AUDI", "AUTOPROFI", "BMW", "FIAT","FORD","FRANCECAR","GM","HONDA","HYUNDAI","LADA","LEXUS","LOGEM","MAZDA","MB","MITSU","NISSAN/INFINITI","OPEL","RENAULT","SKODA","SUBARY","SUZUKIM","TOYOTA","UAZ","VOLGA","VOLVO","VW" ], "departments":[ "Аксессуары","ВАЗ","ГАЗ","Иномарки" ], "items":[ { "images":[ "//static.v-avto.ru/exchange_1c/From1C/c97d4bba-4b2f-11e7-9bed-003048f6ad93_1.jpg?1504342764" ], "p_code":"VNY6", "mog":"120771a", "oem_num":"AWCC1612", "oem_brand":"AIRLINE", "name":"Колпаки 16\" декоративные Airline Х5 передние белые 2 шт. AWCC-16-12", "shipment":1, "delivery":0, "count":7, "count_chel":4, "count_ekb":3, "unit":"компл", "unit_code":839, "price":325.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5a" }, { "images":[ "//static.v-avto.ru/exchange_1c/From1C/d14b4053-bc55-11e6-ab74-e03f497b8d5f_1.jpg?1503899044" ], "p_code":"VNY6", "mog":"52347a", "oem_num":"AWCC1409", "oem_brand":"AIRLINE", "name":"Колпаки 14\" декоративные Airline Торнадо черные глянец, карбон 2 шт. AWCC-14-09", "shipment":1, "delivery":0, "count":4, "count_chel":2, "count_ekb":2, "unit":"компл", "unit_code":839, "price":295.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5b" }, ..., { "images":[ "//static.v-avto.ru/exchange_1c/From1C/d14b4051-bc55-11e6-ab74-e03f497b8d5f_1.jpg?1504517297" ], "p_code":"VNY6", "mog":"52346a", "oem_num":"AWCC1405", "oem_brand":"AIRLINE", "name":"Колпаки 14\" декоративные Airline Лион Т серебристо-черные, карбон 2 шт. AWCC-14-05", "shipment":1, "delivery":0, "count":5, "count_chel":5, "count_ekb":0, "unit":"компл", "unit_code":839, "price":310.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5c" } ] } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/name.xml?q=колпаки
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <page> <current>1</current> <next>2</next> <prev/> <pages>9</pages> <items>433</items> </page> <brands> <brand>AIRLINE</brand> <brand>ATY</brand> <brand>AUDI</brand> <brand>AUTOPROFI</brand> <brand>BMW</brand> <brand>FIAT</brand> <brand>FORD</brand> <brand>FRANCECAR</brand> <brand>GM</brand> <brand>HONDA</brand> <brand>HYUNDAI</brand> <brand>LADA</brand> <brand>LEXUS</brand> <brand>LOGEM</brand> <brand>MAZDA</brand> <brand>MB</brand> <brand>MITSU</brand> <brand>NISSAN/INFINITI</brand> <brand>OPEL</brand> <brand>RENAULT</brand> <brand>SKODA</brand> <brand>SUBARY</brand> <brand>SUZUKIM</brand> <brand>TOYOTA</brand> <brand>UAZ</brand> <brand>VOLGA</brand> <brand>VOLVO</brand> <brand>VW</brand> </brands> <departments> <department>Аксессуары</department> <department>ВАЗ</department> <department>ГАЗ</department> <department>Иномарки</department> </departments> <items> <item> <images> <image>//static.v-avto.ru/exchange_1c/From1C/c97d4bba-4b2f-11e7-9bed-003048f6ad93_1.jpg?1504342764</image> </images> <mog>120771a</mog> <p_code>VNY6</p_code> <oem_num>AWCC1612</oem_num> <oem_brand>AIRLINE</oem_brand> <name>Колпаки 16" декоративные Airline Х5 передние белые 2 шт. AWCC-16-12</name> <shipment>1</shipment> <delivery>0</delivery> <count>7</count> <count_chel>7</count_chel> <count_ekb>0</count_ekb> <unit>компл</unit> <unit_code>839</unit_code> <price>325.0</price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5a</va_item_id> </item> <item> <images> <image>//static.v-avto.ru/exchange_1c/From1C/d14b4053-bc55-11e6-ab74-e03f497b8d5f_1.jpg?1503899044</image> </images> <mog>52347a</mog> <p_code>VNY6</p_code> <oem_num>AWCC1409</oem_num> <oem_brand>AIRLINE</oem_brand> <name>Колпаки 14" декоративные Airline Торнадо черные глянец, карбон 2 шт. AWCC-14-09</name> <shipment>1</shipment> <delivery>0</delivery> <count>4</count> <count_chel>3</count_chel> <count_ekb>1</count_ekb> <unit>компл</unit> <unit_code>839</unit_code> <price>295.0</price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5b</va_item_id> </item> <item> <images> <image>//static.v-avto.ru/exchange_1c/From1C/d14b4051-bc55-11e6-ab74-e03f497b8d5f_1.jpg?1504517297</image> </images> <mog>52346a</mog> <p_code>VNY6</p_code> <oem_num>AWCC1405</oem_num> <oem_brand>AIRLINE</oem_brand> <name>Колпаки 14" декоративные Airline Лион Т серебристо-черные, карбон 2 шт. AWCC-14-05</name> <shipment>1</shipment> <delivery>0</delivery> <count>5</count> <count_chel>0</count_chel> <count_ekb>5</count_ekb> <unit>компл</unit> <unit_code>839</unit_code> <price>310.0</price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5c</va_item_id> </item> </items> </response>
GET /v1/search/cross
Поиск по кроссу
Входные параметры
Параметр | Тип | Описание |
---|---|---|
page | Целое | Указание страницы разбиения. По-умолчанию, 1 |
q | Строка | Поиск по заданному слову или фрагменту. Обязательный параметр |
a | Целое |
Наличие товара: 0 — нет в наличии 1 — имеющийся в продаже не задано — отображается все |
s | Целое |
Сортировка по: 1 — наименованию (по возрастанию) 2 — наименованию (по убыванию) 3 — сроку доставки (по возрастанию) 4 — сроку доставки (по убыванию) 5 — остаткам (по возрастанию) 6 — остаткам (по убыванию) 7 — цене (по возрастанию) 8 — цене (по убыванию) |
b | Строка | Фильтр по бренду |
Ответ сервера: прогресс поиска кросса
При поиске кроссов, система использует не только данные из базы Восхода, но и внешние сервисы. Если запрошенный кросс-номер не известен базе Восхода то, система делает запрос к внешним сервисам, в результате чего, будет возращен статус обработки запроса.
Возвращается объект request
или объект errors
Параметр | Тип | Описание |
---|---|---|
jid | Шестнадцатеричное | Идентификатор задачи |
status | Строка | Статус задачи |
progress | Вещественное | Прогресс задачи в процентах |
message | Строка | Сообщение текущего процесса обработки |
time_total | Вещественное | Общее время работы задачи в секундах |
repeat_after | Вещественное | Количество времени в секундах, через которое рекомендуется повторить запрос. |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.json?q=oc205
Ответ JSON
{ "response": { "job": { "jid":"d3d74db5e64a491bc5ba02a6", "status":"waiting", "progress":0.0, "message":"", "time_total":0.047539 } } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.xml?q=oc205
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <job> <jid>d3d74db5e64a491bc5ba02a6</jid> <status>waiting</status> <progress>0.0</progress> <message></message> <time_total>462.299986</time_total> <repeat_after>0.5</repeat_after> </job> </response>
Ответ сервера: уточнение бренда.
При поиске кросса, система может попросить уточнить бренд, если он не был задан ранее в параметре q
через запятую. Это происходит по тому, что один и тот же кросс-номер может присутствовать у разных брендов.
Возвращается объект brands
или объект errors
Параметр | Тип | Описание |
---|---|---|
brand | Строка | Название бренда |
oem | Строка | Кросс-номер |
name | Строка | Название товара |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.json?q=oc205
Ответ JSON
{ "response": { "brands":[ { "brand":"CLEVITE", "oem":"OC205", "name":"" }, { "brand":"MAHLE", "oem":"OC205", "name":"Фильтр масляный" }, { "brand":"METAL LEVE", "oem":"OC205", "name":"" } ] } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.xml?q=oc205
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <brands> <brand> <brand>CLEVITE</brand> <oem>OC205</oem> <name></name> </brand> <brand> <brand>MAHLE</brand> <oem>OC205</oem> <name>Фильтр масляный</name> </brand> <brand> <brand>METAL LEVE</brand> <oem>OC205</oem> <name></name> </brand> </brands> </response>
Ответ сервера: список кроссов.
Ну и финальный ответ сервера. Возвращаются объекты page
, brands
, target
, items
или объект errors
Объект page
имеет струкруту:
Параметр | Тип | Описание |
---|---|---|
current | Целое | Текущая страница. По-умолчанию, 1 |
next | Целое | Следующая страница |
prev | Целое | Предыдущая страница |
pages | Целое | Всего страниц разбиения |
items | Целое | Количество объектов |
Объект brands
является массивом строк.
Объекты target
и items
имеет струкруту:
Параметр | Тип | Описание |
---|---|---|
images | Массив | Список картинок |
p_code | Строка | Код поставщика. По-умолчанию, "VNY6" |
mog | Строка | Артикул номенклатуры в базе Восхода |
oem_brand | Строка | Бренд производителя |
oem_num | Строка | Артикул производителя |
name | Строка | Название номенклатуры |
shipment | Целое | Кратность покупки |
delivery | Целое | Срок доставки |
count | Целое | Общее количество товара на всех складах |
count_chel | Целое | Количество товара на складе в Челябинске (всего) |
count_chel_st | Целое | Количество товара на складе в Челябинске (Сталеваров) |
count_chel_cin | Целое | Количество товара на складе в Челябинске (Цинковая) |
count_ekb | Целое | Количество товара на складе в Екатеринбурге |
unit_code | Целое | Код единицы измерения |
unit | Целое | Единица измерения |
price | Вещественное | Стоимость товара для клиента |
va_catalog_id | Строка | Идентификатор каталога в 1С |
va_item_id | Строка | Идентификатор товара в 1С |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.json?q=oc205,CLEVITE
Ответ JSON
{ "response": { "page":{ "current":1, "next":null, "prev":null, "pages":1, "items":3 }, "brands":["ARIRANG","MITSU"], "target":[ { "images":[], "p_code":null, "mog":null, "oem_num":"OC205", "oem_brand":"CLEVITE", "name":"", "shipment":1, "delivery":null, "count":0, "count_chel": 0, "count_chel_st":5, "count_chel_cin":3, "count_ekb": 0, "unit":"", "unit_code":0, "price":0.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5f" } ], "items":[ { "images":[], "p_code":"VNY6", "mog":"113610и", "oem_num":"ARG322326", "oem_brand":"ARIRANG", "name":"Фильтр масляный HYUNDAI / KIA", "shipment":1, "delivery":0, "count":68, "count_chel": 18, "count_ekb": 50, "unit":"шт", "unit_code":796, "price":111.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5a" }, { "images":[], "p_code":"VNY6", "mog":"68291и", "oem_num":"MD352626", "oem_brand":"MITSU", "name":"Фильтр масляный HYUNDAI / KIA / MAZDA / MMC / HONDA", "shipment":1, "delivery":999, "count":0, "count_chel": 0, "count_ekb": 0, "unit":"шт", "unit_code":796, "price":222.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5b" }, { "images":[], "p_code":"VNY6", "mog":"60959и", "oem_num":"MZ690150", "oem_brand":"MITSU", "name":"Фильтр масляный HYUNDAI / KIA / MAZDA / MMC / HONDA", "shipment":1, "delivery":999, "count":0, "count_chel": 0, "count_ekb": 0, "unit":"шт", "unit_code":796, "price":226.0, "va_catalog_id": "4c7a8954-e9b8-11e3-a34e-003048f6ad93", "va_item_id": "5b04e522-57d3-11e6-8399-e03f497b8d5c" } ] } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/search/cross.xml?q=oc205,CLEVITE
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <page> >current>1>/current> <next/> <prev/> <pages>1>/pages> <items>3>/items> </page> <brands> <brand>ARIRANG>/brand> <brand>MITSU>/brand> </brands> <target> <item> <images> </images> <mog/> <p_code/> <oem_num>OC205>/oem_num> <oem_brand>CLEVITE>/oem_brand> <name>>/name> <shipment>1>/shipment> <delivery/> <count>0>/count> <count_chel>0>/count_chel> <count_ekb>0>/count_ekb> <unit>>/unit> <unit_code>0>/unit_code> <price>0.0>/price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5f</va_item_id> </item> </target> <items> <item> <images> </images> <mog>113610и>/mog> <p_code>VNY6>/p_code> <oem_num>ARG322326>/oem_num> <oem_brand>ARIRANG>/oem_brand> <name>Фильтр масляный HYUNDAI / KIA>/name> <shipment>1>/shipment> <delivery>0>/delivery> <count>68>/count> <count_chel>18>/count_chel> <count_ekb>50>/count_ekb> <unit>шт>/unit> <unit_code>796>/unit_code> <price>111.0>/price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5a</va_item_id> </item> <item> <images> </images> <mog>68291и>/mog> <p_code>VNY6>/p_code> <oem_num>MD352626>/oem_num> <oem_brand>MITSU>/oem_brand> <name>Фильтр масляный HYUNDAI / KIA / MAZDA / MMC / HONDA>/name> <shipment>1>/shipment> <delivery>999>/delivery> <count>0>/count> <count_chel>0>/count_chel> <count_ekb>0>/count_ekb> <unit>шт>/unit> <unit_code>796>/unit_code> <price>222.0>/price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5b</va_item_id> </item> <item> <images> </images> <mog>60959и>/mog> <p_code>VNY6>/p_code> <oem_num>MZ690150>/oem_num> <oem_brand>MITSU>/oem_brand> <name>Фильтр масляный HYUNDAI / KIA / MAZDA / MMC / HONDA>/name> <shipment>1>/shipment> <delivery>999>/delivery> <count>0>/count> <count_chel>0>/count_chel> <count_ekb>0>/count_ekb> <unit>шт>/unit> <unit_code>796>/unit_code> <price>226.0>/price> <va_catalog_id>4c7a8954-e9b8-11e3-a34e-003048f6ad93</va_catalog_id> <va_item_id>5b04e522-57d3-11e6-8399-e03f497b8d5c</va_item_id> </item> </items> </response>