API сайта Корона Авто реализовано в виде запросов по HTTP протоколу на URL, соответсвующие тем или иным функциям API. Все параметры запроса могут быть переданы как в виде GET-параметров, так и в теле POST запроса в url-encoded форме.
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
apiUid | Строка | Да | Уникальный идентификатор API-клиента. Выдается менеджером по запросу. Привязан к IP клиента. |
dataType | Строка | Нет | Формат ответа сервера. По умолчанию «xml». На данный момент поддерживаются форматы «xml» и «json». |
В случае возникновения ошибок сервер возвращает в ответе единственный параметр error с текстовым описанием ошибки.
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
q | Строка | Да | Строка поискового запроса |
searchType | Строка | Нет | Тип поиска. По умолчанию «contain». Может содержать: "contain" - поиск по вхождению или "eq" - поиск по точному соответствию. |
Имя параметра | Описание |
---|---|
product | Массив объектов товаров |
product / id | Уникальный идентификатор товара в магазине Корона Авто. |
product / name | Наименование детали |
product / producer | Производитель детали |
product / factory_number | Заводской номер детали (артикул) |
product / find_by | Источник поиска: FACTORY_NUMBER - Оригинал, ANALOG_NUMBER - Аналог |
<?xml version="1.0"?> <response> <product> <id>2319956</id> <name>Опора резиновая M8/M10xSW30x31 ДАФ (050.034)</name> <producer>SAMPA</producer> <factory_number>050.034</factory_number> <find_by>FACTORY_NUMBER</find_by> </product> </response>
{ "product":[ { "id":2319956, "name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", "producer":"SAMPA", "factory_number":"050.034", "find_by":"FACTORY_NUMBER" } ] }
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
id | Строка | Да | Уникальный идентификатор товара в магазине Корона Авто. |
Имя параметра | Описание |
---|---|
product | Объект описания товара |
product / name | Наименование детали |
product / producer | Наименование производителя |
product / factory_number | Номер производителя (артикул) |
product / original_number | Оригинальный номер детали |
product / weight | Вес детали, кг |
product / volume | Объем детали, мм3 |
product / height | Высота детали, мм |
product / width | Ширина детали, мм |
product / length | Длина(глубина) детали, мм |
<?xml version="1.0"?> <response> <product> <name>Опора резиновая M8/M10xSW30x31 ДАФ (050.034)</name> <producer>SAMPA</producer> <brand>DAF</brand> <factory_number>050.034</factory_number> <original_number>1233247</original_number> <weight>0.08</weight> <volume/> <height/> <width/> <length/> </product> </response>
{ "product":{ "name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", "producer":"SAMPA", "brand":"DAF", "factory_number":"050.034", "original_number":"1233247", "weight":"0.08", "volume":null, "height":null, "width":null, "length":null } }
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
id | Строка | Да | Уникальный идентификатор товара в магазине Корона Авто. |
Имя параметра | Описание |
---|---|
product | Объект описания товара |
product / name | Наименование детали |
product / producer | Наименование производителя |
product / factory_number | Номер производителя (артикул) |
product / prices | Массив цен продукта по складам |
product / prices / warehouse | Объект цен по определенному складу |
product / prices / warehouse / name | Склад (наименование), по которому действует цена |
product / prices / warehouse / value | Значение цены |
product / prices / warehouse / currency | Валюта (3-х буквенный код) |
<?xml version="1.0"?> <response> <product> <name>Опора резиновая M8/M10xSW30x31 ДАФ (050.034)</name> <producer>SAMPA</producer> <factory_number>050.034</factory_number> <prices> <warehouse> <name>Санкт-Петербург</name> <value>336.93</value> <currency>RUB</currency> </warehouse> </prices> </product> </response>
{ "product": { "name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", "producer":"SAMPA", "factory_number":"050.034", "prices":[ { "warehouse":{ "name":"Санкт-Петербург", "value":336.93 , "currency":"RUB" } } ] } }
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
id | Строка | Да | Уникальный идентификатор товара в магазине Корона Авто. |
Имя параметра | Описание |
---|---|
product | Объект описания товара |
product / name | Наименование детали |
product / producer | Наименование производителя |
product / factory_number | Номер производителя (артикул) |
product / stock | Массив остатков товара по складам |
product / stock / warehouse | Остатки товара по определенному складу |
product / stock / warehouse / name | Склад (наименование), по которому действует цена |
product / stock / warehouse / quantity | Доступное количество товара на складе |
<?xml version="1.0"?> <response> <product> <name>Опора резиновая M8/M10xSW30x31 ДАФ (050.034)</name> <producer>SAMPA</producer> <factory_number>050.034</factory_number> <stock> <warehouse> <name>Санкт-Петербург</name> <quantity>5</quantity> </warehouse> </stock> </product> </response>
{ "product": { "name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", "producer":"SAMPA", "factory_number":"050.034", "prices":[ { "warehouse":{ "name":"Санкт-Петербург", "quantity":5 , } } ] } }
Выводит суммарную информацию по товару (функции description, price и stock)
Имя параметра | Тип | Обязательный | Описание |
---|---|---|---|
id | Строка | Да | Уникальный идентификатор товара в магазине Корона Авто. |
см. описание функций Характеристики товара, Цены товара, Остатки товара на складах,