BaseTrack реальная экономия топлива

API Корона Авто

API сайта Корона Авто реализовано в виде запросов по HTTP протоколу на URL, соответсвующие тем или иным функциям API. Все параметры запроса могут быть переданы как в виде GET-параметров, так и в теле POST запроса в url-encoded форме.

Общие параметры

Имя параметраТипОбязательныйОписание
apiUid Строка Да Уникальный идентификатор API-клиента. Выдается менеджером по запросу. Привязан к IP клиента.
dataType Строка Нет Формат ответа сервера. По умолчанию «xml». На данный момент поддерживаются форматы «xml» и «json».

Обработка ошибок

В случае возникновения ошибок сервер возвращает в ответе единственный параметр error с текстовым описанием ошибки.

Функции API

Поиск товаров

URL:
/api/search/
Параметры запроса:
Имя параметраТипОбязательныйОписание
q Строка Да Строка поискового запроса
searchType Строка Нет Тип поиска. По умолчанию «contain». Может содержать: "contain" - поиск по вхождению или "eq" - поиск по точному соответствию.
Ответ:
Имя параметраОписание
product Массив объектов товаров
product / id Уникальный идентификатор товара в магазине Корона Авто.
product / name Наименование детали
product / producer Производитель детали
product / factory_number Заводской номер детали (артикул)
product / find_by Источник поиска: FACTORY_NUMBER - Оригинал, ANALOG_NUMBER - Аналог
Пример запроса:
http://old.korona-auto.com/api/search/?q=M12332&apiUid=xxxxxx&dataType=json
Пример ответа XML:
<?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>
Пример ответа JSON:
{
	"product":[
		{
			"id":2319956,
			"name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)",
			"producer":"SAMPA",
			"factory_number":"050.034",
			"find_by":"FACTORY_NUMBER"
		}
	]
}

Характеристики товара

URL:
/api/product/description/
Параметры запроса:
Имя параметраТипОбязательныйОписание
id Строка Да Уникальный идентификатор товара в магазине Корона Авто.
Ответ:
Имя параметраОписание
product Объект описания товара
product / name Наименование детали
product / producer Наименование производителя
product / factory_number Номер производителя (артикул)
product / original_number Оригинальный номер детали
product / weight Вес детали, кг
product / volume Объем детали, мм3
product / height Высота детали, мм
product / width Ширина детали, мм
product / length Длина(глубина) детали, мм
Пример запроса:
http://old.korona-auto.com/api/product/description/?id=2319956&apiUid=aaa&dataType=json
Пример ответа XML:
<?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>
Пример ответа JSON:
{ 
	"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 
	} 
}

Цены товара

URL:
/api/product/price/
Параметры запроса:
Имя параметраТипОбязательныйОписание
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-х буквенный код)
Пример запроса:
http://old.korona-auto.com/api/product/price/?id=2319956&apiUid=xxxxxx&dataType=json
Пример ответа XML:
<?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>
Пример ответа JSON:
{ 
	"product": {
		"name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", 
		"producer":"SAMPA", 
		"factory_number":"050.034", 
		"prices":[ 
			{ 
				"warehouse":{ 
					"name":"Санкт-Петербург", 
					"value":336.93 ,
					"currency":"RUB"
				} 
			} 
		] 
	}
}

Остатки товара на складах

URL:
/api/product/stock/
Параметры запроса:
Имя параметраТипОбязательныйОписание
id Строка Да Уникальный идентификатор товара в магазине Корона Авто.
Ответ:
Имя параметраОписание
product Объект описания товара
product / name Наименование детали
product / producer Наименование производителя
product / factory_number Номер производителя (артикул)
product / stock Массив остатков товара по складам
product / stock / warehouse Остатки товара по определенному складу
product / stock / warehouse / name Склад (наименование), по которому действует цена
product / stock / warehouse / quantity Доступное количество товара на складе
Пример запроса:
http://old.korona-auto.com/api/product/stock/?id=2319956&apiUid=xxxxxx&dataType=json
Пример ответа XML:
<?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>
Пример ответа JSON:
{ 
	"product": {
		"name":"Опора резиновая M8/M10xSW30x31 ДАФ (050.034)", 
		"producer":"SAMPA", 
		"factory_number":"050.034", 
		"prices":[ 
			{ 
				"warehouse":{ 
					"name":"Санкт-Петербург", 
					"quantity":5 ,
				} 
			} 
		] 
	}
}

Суммарная информация по товару

URL:
/api/product/info/

Выводит суммарную информацию по товару (функции description, price и stock)

Параметры запроса:
Имя параметраТипОбязательныйОписание
id Строка Да Уникальный идентификатор товара в магазине Корона Авто.
Ответ:

см. описание функций Характеристики товара, Цены товара, Остатки товара на складах,

 
©2011—2024 «Корона Авто». Все права защищены.
Рейтинг@Mail.ru AUTOLORD
198095, Россия, г. Санкт-Петербург, ул. Маршала Говорова, 49
Телефон: 8 800 100-36-16
Эл.почта: sales@korona-auto.com • office@korona-auto.com