WEB сервис avtomagen.ru

1. Получение списка брендов

Запрос вида GET:

 https://avtomagen.ru/api/brands/?api=1f32aa4c0a1d2ea010adcf2348166a04&number=oc264&useOnlineStocks=1

Возвращает массив JSON вида :

[

  {
"unic": "MAHLE/KNECHT OC264", 
"brand": "MAHLE/KNECHT",
"code": "OC264",
"name": "Масляный фильтр",
"grcross": "3723",
"url_image": "images/54/294053.jpg"
},
 
  {
"unic": "REINZ OC264",
"brand": "REINZ",
"code": "OC264",
"name": "REINZ : Фильтр масляный",
"grcross": null,
"url_image": null
},
 
  {
"unic": "TOTACHI OC264",
"brand": "TOTACHI",
"code": "OC264",
"name": "TOTACHI : Tc-1022 ( vic c-010 ) oem 15208-v4000",
"grcross": null,
"url_image": null
}
 

],

2.  Получение списка предложений по КОДУ и БРЕНДУ

Запрос вида GET:

https://avtomagen.ru/api/articles/?api=1f32aa4c0a1d2ea010adcf2348166a04&brand=KNECHT&number=oc264&grcross=3723&useOnlineStocks=1

Возвращает массив JSON вида :

[

  {
"distr": "4",
"s": "d6dcd0c3c096ba49fe7a3dc088ee779b",
"data": [
  {
"a": "0",
"b": "",
"c": "BOSCH",
"d": "1165",
"i": "0451103314",
"f": "ФИЛЬТР МАСЛА OC264 / Ауди 100 2 6-2 8инж Пассат В5 / T5 2010- 2.0 AXA WL7071 06A115561B 50013529 100653 25-1234 W719/30 CADDY 1.6 OCTAVIA",
"g": "1",
"k": "385",
"l": "385",
"m": "24ff06",
"n": "0",
"o": "AME_Stock",
"p": 3723,
"q": "images/54/294040.jpg",
"r": "OC264",
"t": ""
},
 
  {
"a": "1",
"b": "",
"c": "GLOBER",
"d": "2865",
"i": "251234",
"f": "ФИЛЬТР МАСЛА OC264 / Ауди 100 2 6-2 8инж Пассат В5 / T5 2010- 2.0 AXA WL7071 06A115561B 50013529 100653 25-1234 W719/30 CADDY 1.6 OCTAVIA",
"g": "1",
"k": "261.8",
"l": "261.8",
"m": "24ff06",
"n": "0",
"o": "AME_Stock",
"p": 3723,
"q": "images/54/294053.jpg",
"r": "OC264",
"t": ""
},
 
  {
"a": "2",
"b": "",
"c": "DODA",
"d": "1778",
"i": "1110020004",
"f": "ФИЛЬТР МАСЛА OC264 / Ауди 100 2 6-2 8инж Пассат В5 / T5 2010- 2.0 AXA WL7071 06A115561B 50013529 100653 25-1234 W719/30 CADDY 1.6 OCTAVIA",
"g": "8",
"k": "218.4",
"l": "218.4",
"m": "24ff06",
"n": "0",
"o": "AME_Stock",
"p": 3723,
"q": "images/54/294053.jpg",
"r": "OC264",
"t": ""
},
 
  {
"a": "3",
"b": "",
"c": "ZEKKERT",
"d": "7382",
"i": "OF4095",
"f": "ФИЛЬТР МАСЛА OC264 / Ауди 100 2 6-2 8инж Пассат В5 / T5 2010- 2.0 AXA WL7071 06A115561B 50013529 100653 25-1234 W719/30 CADDY 1.6 OCTAVIA",
"g": "1",
"k": "263.2",
"l": "263.2",
"m": "24ff06",
"n": "0",
"o": "AME_Stock",
"p": 3723,
"q": "images/54/294053.jpg",
"r": "OC264",
"t": ""
},
 
],
 
}

]

ОПИСАНИЕ ПОЛЕЙ РЕЗУЛЬТАТА ЗАПРОСА :

 

"distr": "4", - номер поставщика в базе доступный для проценки / не важный параметр

"s": "d6dcd0c3c096ba49fe7a3dc088ee779b", - Код текущего поиска где хранятся все результаты данного поставщика. Срок хранения ограничен от 1 до 24 часов час

Пока данный код существует, запросы будут выводится из КЭША. После истечения срока, будут снова опрошены все поставщики. / Важный параметр

по которому находятся все позиции из запросов

data - Массив переданных артикулов :

 -- для уменьшения веса передаваемого JSON поля обозначены одной буквой.

  • "a": "3", --- Позиция в поисковом запросе. для передачи поставщику в онлайн заказ
  • "b": "", --- необязательный параметр. может быть код поставщика
  • "c": "ZEKKERT", --- БРЕНД
  • "d": "7382", Код бренда в таблице брендов сайта поставщика
  • "i": "OF4095" - код Артикул товара . всегда передается очищенный ...
  • "f": "ФИЛЬТР МА ... -- Наименование /  описание
  • "g": "1", - НАЛИЧЕ НА СКЛАДЕ . Остаток .
     
  • "k": "263.2", Цена с учетом скидки . Входная цена на клиента
  • "l": "263.2", Розничная цена. Не обязательный параметр..
  • "m": "24ff06", - Цвет поставщиков, есил прайс сборный то каждый Поставщик своим цветом
  • "n": "0", ---  Срок Доставки в часах до склада Сайта.
  • "o": "Парма", -  наименование СКЛАДА поставщика. / Прайса поставщика /  КОД поставщика буквенный
  • "p": 3723, -- Группа кроссов в которой будет производится поиск аналогов
  • "q": "images/54/294053.jpg", - Ссылка на изображение артикула из ТЕКДОК 2016
  • "r": "OC264" -- ОБЩЕЕ Описание группы кроссов для кроссирования
  • "t": "RUPAR"  --  Код поставщика прайса для сайта..
3. Отправка позиции в заказ:
Запрос вида POST:
https://avtomagen.ru/api/ordersend/?
api=1f32aa4c9a1d2ea010adcf2348166a04&positions[0][pos]=1&positions[0][searchid]=0b4ec109c92a4bd085e5c4a11c4f7f67&positions[0][quantity]=1&positions[0][comment]=1&&positions[1][pos]=2&positions[1][searchid]=0b4ec109c92a4bd085e5c4a11c4f7f67&positions[1][quantity]=1&positions[1][comment]=2
 
В системе нет принципа заказа из нескольких позиций. Каждая позиция имеет уникальный номер заказа. 
Описание полей запроса :
  • api - обязательный ключ идентификации, получаем по запросу у администратора
  • positions - Массив передаваемых позиций
    • ​​pos - номер позиции в поисковом запросе с сайта
    • searchid - id поискового запроса. Время жизни ограничено от 1 до 24ч
    • quantity - количество требуемого артикула. если передать больше,чем есть на складе, будет заказано максимальное текущее количество на складе
    • comment - коментарий переданый поставщику​

Возвращает либо ошибку. либо массив успешных позиций

{

"orders": [
  {
"status": "0",
"pos": "1",
"searchid": "1bf44d64ac070731a3fd075906f58a64",
"errorCode": 301,
"errorMessage": "Истёк срок действия поискового запроса. Добавление невозможно."
},
 
  {
"status": "1",
"searchid": "a9bdde1ac7389cb50b8845f7dfff91e4",
"pos": "2",
"order": "440"
}
 
],
 

}

После размещения заказа опрашиваем текущий стату

Запрос вида GET:

с 

https://avtomagen.ru/api/orderstatus/?api=1f32aa4c0a1d2ea010adcf2348166a04&orders[0]=431&orders[1]=61

Ответ 

{

"status": [
  {
"Order": "431",
"statusDate": "00-00-0000",
"statusCode": "2",
"statusName": "Отправлен Поставщику",
"statusColor": "ffde7bed"
},
 
  {
"Order": "61",
"statusDate": "16-01-2018",
"statusCode": "6",
"statusName": "В Магазине",
"statusColor": "06ff44"
}
 
],
 

}