logo-UniqDigital.jpg

http://uniq.by

API каталога запчастей Autotovar.by

API Autotovar.by – это инструмент для интернет-магазинов, работающих с Autotovar.by.

API Autotovar.by позволяет

Получать данные по наличию запчастей прямо из базы данных Autotovar.by. Таким образом Вы получаете актуальную информацию по более чем 15 000 запчастей в каталоге Autotovar.by

API Autotovar.by может использоваться в системах следующих типов

 

Целью создания API является предоставление сторонним автоматизированным системам интерфейса взаимодействия с каталогом запчастей Autotovar.by, исключая пользовательский веб-интерфейс.

Таким образом вы можете продавать запчасти на своем сайте, со своей корзиной покупок.


Вызов методов

Запросы к API могут передаваться по протоколу HTTP.

Запрос к сервису задается в следующем формате:

GET http://autotovar.by/api?module=catalog&format=<формат_результата>&token=<api_ключ>&<параметры>

<формат_результата> - это необязательная часть запроса, которая влияет на способ представления результата. Возможные варианты: xml, json. По умолчанию данные передаются в формате JSON.

<api_ключ> - ключ для доступа к API. Ключ является уникальным для каждого пользователя autotovar.by. Для получения ключа необходимо обратиться к менеджеру.

<параметры> - обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.

Все передаваемые параметры должны быть в кодировке UTF-8 и закодированы функцией urlencode (http://php.net/manual/ru/function.urlencode.php)


Примеры запросов

1. Получение марок авто

Запрос

http://www.autotovar.by/api/?module=catalog&format=xml&action=marka

Ответ

<marks>

<items>

<item>

<marka>Acura</marka>

</item>

<item>

<marka>Alfa Romeo</marka>

</item>

<item>

<marka>Audi</marka>

</item>

<item>

<marka>BMW</marka>

</item>

<item>

    </items>

    <total>42</total>

</marks>

2. Получение моделей авто по марке

Запрос

http://www.autotovar.by/api/?module=catalog&format=xml&action=model&marka=BMW

Ответ

<models>

        <items>

                <item>

                        <marka>BMW</marka>

                        <model>1 (E87)</model>

                </item>

                <item>

                        <marka>BMW</marka>

                        <model>3 (E30)</model>

                </item>

                <item>

                        <marka>BMW</marka>

                        <model>3 (E36)</model>

                </item>

                <item>

                        <marka>BMW</marka>

                        <model>3 (E46)</model>

                </item>

                ...

        </items>

        <total>15</total>

</models>


3. Получение годов выпуска по модели и марке авто

Запрос

http://www.autotovar.by/api/?module=catalog&format=json&action=year&marka=Acura&model=TSX

Ответ

{

years: {

items: [

{

marka: Acura

model: TSX

year: 2004-2008

}

]

total: 1

}

}

4. Получение групп запчастей по модели, марке и году выпуска авто

Запрос

http://www.autotovar.by/api/?module=catalog&format=xml&action=group&marka=BMW&model=5%20(E34)&year=12.1987-11.1995

Ответ

{

groups: {

items: [

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: АРКИ

}

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: БАМПЕРА И ДЕТАЛИ

}

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: ЗАЩИТА ДВИГАТЕЛЯ

}

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: ЗЕРКАЛА И ДЕТАЛИ

}

]

total: 17

}

}

5. Получение списка запчастей по марке, модели и году выпуска

Запрос

http://www.autotovar.by/api/?module=catalog&format=xml&action=part&marka=BMW&model=5%20(E34)&year=12.1987-11.1995

Ответ

<parts>

<items>

<item>

<marka>BMW</marka>

<model>5 (E34)</model>

<year>12.1987-11.1995</year>

<group>РАДИАТОР ОХЛАЖДЕНИЯ</group>

<product_title>РАДИАТОР ДВИГАТЕЛЯ</product_title>

<product_code>60596A</product_code>

<original_number>1243510</original_number>

<product_inf>"3.0, 3.5</product_inf>

<manufacturer>Valsens</manufacturer>

<availability>938810</availability>

<price>0</price>

<image>http://www.autotovar.by/img/parts_full/60596a.jpg</image>

</item>

<item>

<marka>BMW</marka>

<model>5 (E34)</model>

<year>12.1987-11.1995</year>

<group>ОПТИКА ПЕРЕДНЯЯ</group>

<product_title>СТЕКЛО ПРОТИВОТУМАННОЙ ФАРЫ (ПРАВОЕ)</product_title>

<product_code>SBM2002(K)R</product_code>

<original_number>DL-O-012-1R</original_number>

<product_inf/>

<manufacturer>Dingliang</manufacturer>

<availability>7</availability>

<price>79430</price>

<image>

http://www.autotovar.by/img/parts_full/sbm2002(k)r.jpg

</image>

</item>

</items>

<total>95</total>

</parts>


6. Получение списка запчастей по марке, модели, году выпуска и группе

Запрос

http://www.autotovar.by/api/?module=catalog&format=json&action=part&marka=BMW&model=5%20(E34)&year=12.1987-11.1995&group=ОПТИКА%20ПЕРЕДНЯЯ

Ответ

{

parts: {

items: [

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: ОПТИКА ПЕРЕДНЯЯ

product_title: СТЕКЛО ПРОТИВОТУМАННОЙ ФАРЫ (ПРАВОЕ)

product_code: SBM2002(K)R

original_number: DL-O-012-1R

product_inf:

manufacturer: Dingliang

availability: 7

price: 79430

image: http://www.autotovar.by/img/parts_full/sbm2002(k)r.jpg

}

{

marka: BMW

model: 5 (E34)

year: 12.1987-11.1995

group: ОПТИКА ПЕРЕДНЯЯ

product_title: СТЕКЛО ПРОТИВОТУМАННОЙ ФАРЫ (ЛЕВОЕ)

product_code: SBM2002(K)L

original_number: DL-O-012-1L

product_inf:

manufacturer: Dingliang

availability: 7

price: 79430

image: http://www.autotovar.by/img/parts_full/sbm2002(k)l.jpg

}

]

total: 20

}

}

7. Поиск по коду детали

Запрос

http://www.autotovar.by/api/?module=catalog&format=xml&action=searchCode&code=PBM07012GBR

Ответ

<parts>

<items>

<item>

<marka>BMW</marka>

<model>3 (E46)</model>

<year>09.2001-04.2005</year>

<group>РЕШЕТКА РАДИАТОРА</group>

<product_title>РЕШЕТКА РАДИАТОРА (ПРАВАЯ)</product_title>

<product_code>PBM07012GBR</product_code>

<original_number>GD3343SR</original_number>

<product_inf>седан/туринг, полностью хромированная</product_inf>

<manufacturer>Jesselai</manufacturer>

<availability/>

<price>386950</price>

<image>

http://www.autotovar.by/img/parts_full/pbm07012gbr.jpg

</image>

</item>

</items>

<total>1</total>

</parts>