Поиск
Ресурсы
| Ссылка | Тип запроса | Описание |
|---|---|---|
| /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>