История страницы

Запрос

Метод

Пример

Комментарий

Получить все категории

GetRootCategoryInfoList

http://docs.otapi.net/ru/Documentations/Method/GetRootCategoryInfoList?language=ru&signature=&timestamp= 

ℹ️ Наше АПИ не позволяет получить все продукты во всех категориях сразу. Сначала запрашиваем главные (корневые) категории, затем по-отдельности запрашиваем подкатегории второго, третьего, … уровня

Получить подкатегории в категории

GetCategorySubcategoryInfoList 

http://docs.otapi.net/ru/Documentations/Method/GetCategorySubcategoryInfoList?language=ru&signature=&timestamp=&parentCategoryId=otc-1 

Получить товары в категории (поиск по категории)

BatchSearchItemsFrame

http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CCategoryId%3Eotc-13%3C%2FCategoryId%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=10&blockList= 

В xmlParametersуказываем номер категории (например, otc-1): <SearchItemsParameters><CategoryId>otc-1</CategoryId></SearchItemsParameters> 

Получить номер категории можно 2-мя способами:

1️⃣ по АПИ методом http://docs.otapi.net/ru/Documentations/Method?name=BatchGetItemFullInfo. В blockList параметре указываем RootPath

2️⃣ через сайт (https://clip.otcommerce.com/files/40/48/category.jpg). в адресной строке последние цифры - это номер категории

Получить информацию о товаре 

BatchGetItemFullInfo

http://docs.otapi.net/ru/Documentations/Method/BatchGetItemFullInfo?language=ru&signature=&timestamp=&sessionId=&itemParameters=&itemId=788547215798&blockList=Description  

itemId - указываем ID товара (для Таобао без префикса. для других провайдеров указываем префикс)

blockList - добавляем Description, если нужно фото, видео и описание товара

Получить SKU товара и конфигурации

BatchGetItemFullInfo

http://docs.otapi.net/ru/Documentations/Method/BatchGetItemFullInfo?language=ru&signature=&timestamp=&sessionId=&itemParameters=&itemId=788547215798&blockList=Description  

Если у товара есть конфигурации, ответ будет содержать:

<OtapiConfiguredItem>

<Id>..............</Id> - это SKU

В разделе <Attributes> передаются конфигурации товара. Например:

<ItemAttribute Pid="风格" Vid="日韩">

<PropertyName>Style</PropertyName>

<Value>Japanese and Korean</Value>

<OriginalPropertyName>风格</OriginalPropertyName>

<OriginalValue>日韩</OriginalValue>

<IsConfigurator>false</IsConfigurator>

</ItemAttribute>

Pid - идентификатор свойства товара, а VID - значение этого свойства (например, 

Pid="цвет" Vid="черный").

Получить количество проданных товаров

BatchGetItemFullInfo

http://docs.otapi.net/ru/Documentations/Method/BatchGetItemFullInfo?language=ru&signature=&timestamp=&sessionId=&itemParameters=&itemId=41202605330&blockList= 

Находим значения:

SalesInLast30Days

TotalSales

Поиск товара по разным параметрам (артикулу, слову, фразе, продавцу и др.)

BatchSearchItemsFrame

ℹ️ Все параметры поиска в документации

1 провайдер: http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CItemTitle%3E%D0%BF%D0%BB%D0%B0%D1%82%D1%8C%D0%B5%3C%2FItemTitle%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=5&blockList=

Несколько провайдеров: http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CProvider%3ETaobao%3C%2FProvider%3E%3CItemTitle%3E%D0%BF%D0%BB%D0%B0%D1%82%D1%8C%D0%B5%3C%2FItemTitle%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=5&blockList= 

Если 1 провайдер, в

xmlParameters указываем поисковый запрос: 

(например, платье) <SearchItemsParameters><ItemTitle>платье</ItemTitle></SearchItemsParameters>

ℹ️ Максимально 200 товаров за 1 запрос

Если несколько провайдеров, в

xmlParameters указываем нужный провайдер и поисковый запрос (например, платье на Таобао): 

<SearchItemsParameters><Provider>Taobao</Provider><ItemTitle>платье</ItemTitle></SearchItemsParameters>

ℹ️ Максимально 200 товаров за 1 запрос

Поиск по фото

BatchSearchItemsFrame

1 провайдер: http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CImageUrl%3Ehttps%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi1%2F529782397%2FO1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg%3C%2FImageUrl%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=5&blockList= 

Несколько провайдеров: http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CProvider%3ETaobao%3C%2FProvider%3E%3CImageUrl%3Ehttps%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi1%2F529782397%2FO1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg%3C%2FImageUrl%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=5&blockList= 

Если 1 провайдер, в

xmlParameters указываем ссылку на фото: <SearchItemsParameters><ImageUrl>https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg</ImageUrl></SearchItemsParameters>

ℹ️ Максимально 200 товаров за 1 запрос

Если несколько провайдеров, в

xmlParameters указываем нужный провайдер и ссылку на фото (например, на Таобао): <SearchItemsParameters><Provider>Taobao</Provider><ImageUrl>https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg</ImageUrl></SearchItemsParameters>

ℹ️ Максимально 200 товаров за 1 запрос

⚠️ Ссылка на фото может быть любая, например https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg, но она должна быть доступна к просмотру в любом браузере

⚠️ Поиск по фото - это дополнительный платный модуль. Стоимость - 170$ (единоразовая оплата) для каждого провайдера

Поиск по бренду

BatchSearchItemsFrame

Для Таобао: http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CBrandId%3EAdidas%3C%2FBrandId%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=10&blockList= 

Для других провайдеров:http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CItemTitle%3EAdidas%3C%2FItemTitle%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=10&blockList= 

Для Таобао (например, бренд Adidas) 

1️⃣ добавляем бренд в список брендов в админке АПИ Ключа:

Каталог –> Подборки –> Популярные бренды (https://clip.otcommerce.com/files/ac/f5/brandsrus.jpg). Бренд можно добавить:

- из спискаhttps://clip.otcommerce.com/files/19/3b/brandsrus2.jpg

- по ссылке или Idhttps://clip.otcommerce.com/files/02/08/brandsrus3.jpg. Ссылку или ID можно взять на сайтеhttps://open-demo.otcommerce.com/?q=brands (https://clip.otcommerce.com/files/3d/cd/brandsrus4.jpg ->https://clip.otcommerce.com/files/dc/40/brandsrus5.jpg)

ℹ️ ID надо брать точно из ссылки (например, ot:34657)

2️⃣ далее делаем запрос, используя методBatchSearchItemsFrame. В xmlParameters указываем <SearchItemsParameters><BrandId>Adidas</BrandId></SearchItemsParameters>

Для других провайдеров бренд в список брендов в админке АПИ Ключа не добавляем. Делаем запрос как при поиске по слову, фразе, продавцу и другим фильтрам, используя методBatchSearchItemsFrame. в

xmlParameters

указываем бренд (например, Adidas): 

<SearchItemsParameters><ItemTitle>Adidas</ItemTitle></SearchItemsParameters>

Поиск по продавцу

BatchSearchItemsFrame

http://docs.otapi.net/ru/Documentations/Method/BatchSearchItemsFrame?language=ru&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CVendorId%3Emyczx8%3C%2FVendorId%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=5&blockList= 

В

xmlParameters указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg) 

Получить информацию о продавце (местоположение, рейтинг и т.п.)

GetVendorInfo

или 

BatchGetItemFullInfo 

http://docs.otapi.net/ru/Documentations/Method/GetVendorInfo?language=ru&signature=&timestamp=&vendorId=myczx8

http://docs.otapi.net/ru/Documentations/Method/BatchGetItemFullInfo?language=ru&signature=&timestamp=&sessionId=&itemParameters=&itemId=805601642351&blockList=Vendor 

В vendorId указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg). Рейтинг продавца в нашем АПИ - Level

В blockList указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg). Рейтинг продавца в нашем АПИ - Level

Получить стоимость внутренней доставки

BatchGetItemFullInfo

http://docs.otapi.net/ru/Documentations/Method/BatchGetItemFullInfo?language=ru&signature=&timestamp=&sessionId=&itemParameters=&itemId=865203335795&blockList=DeliveryCosts 

В block list указываем DeliveryCosts

В коде ищем по словам Internaldelivery (без пробела)

ℹ️ Невозможно получить стоимость внутренней доставки продукта по определенному адресу через API. Нужно установить его в админке АПИ Ключа.

Получить языки для АПИ Ключа

GetLanguageInfoList

http://docs.otapi.net/ru/Documentations/Method/GetLanguageInfoList?language=ru&signature=&timestamp= 

ℹ️ В стоимость АПИ Ключей K0 Basic, K1 Standard и K2 Advanced входит только 1 язык. Чтобы подключить дополнительный язык, необходимо подключение платного модуля «Мультиязычность». Цена

ℹ️ Для Ключа K3 Enterprise доступно неограниченное количество языков.