ООО Восход

Поиск

Ресурсы

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