...
Запрос | Метод | Пример | Комментарий |
Получить все категории | ℹ️ Наше АПИ не позволяет получить все продукты во всех категориях сразу. Сначала запрашиваем главные (корневые) категории, затем по-отдельности запрашиваем подкатегории второго, третьего, … уровня | ||
Получить подкатегории в категории | |||
Получить товары в категории (поиск по категории) | В 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). в адресной строке последние цифры - это номер категории | ||
Получить нужное количество товаров провайдера | В xmlParameters указываем провайдера и категорию (например, Таобао и категория otc-1): <SearchItemsParameters><Provider>Taobao</Provider><CategoryId>otc-1</CategoryId></SearchItemsParameters> В frameSize указываем необходимое количество товаров (например, 20) | ||
Получить информацию о товаре | itemId - указываем ID товара (для Таобао без префикса. для других провайдеров указываем префикс) blockList - добавляем Description, если нужно фото, видео и описание товара | ||
Получить SKU товара и конфигурации | Если у товара есть конфигурации, ответ будет содержать: <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="черный"). | ||
Получить количество проданных товаров | Находим значения: SalesInLast30Days TotalSales | ||
Поиск товара по разным параметрам (артикулу, слову, фразе, продавцу и др.) | ℹ️ Все параметры поиска в документации | 1 провайдер: Пример в документации | В xmlParameters указываем поисковый запрос (например, платье): <SearchItemsParameters><ItemTitle>платье</ItemTitle></SearchItemsParameters> ℹ️ Максимально 200 товаров за 1 запрос |
Несколько провайдеров: | В xmlParameters указываем нужный провайдер и поисковый запрос (например, платье на Таобао): <SearchItemsParameters><Provider>Taobao</Provider><ItemTitle>платье</ItemTitle></SearchItemsParameters> ℹ️ Максимально 200 товаров за 1 запрос | ||
Поиск по фото | 1 провайдер:
| В xmlParameters указываем ссылку на фото (например, https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg): <SearchItemsParameters><ImageUrl>https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg</ImageUrl></SearchItemsParameters> ℹ️ Максимально 200 товаров за 1 запрос ⚠️ Ссылка на фото может быть любая, но она должна быть доступна к просмотру в любом браузере ⚠️ Поиск по фото - это дополнительный платный модуль. Стоимость - 170$ (единоразовая оплата) для каждого провайдера. | |
Несколько провайдеров: | В 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$ (единоразовая оплата) для каждого провайдера | ||
Поиск по бренду | Для Таобао:
| Например, бренд 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> | ||
Поиск по продавцу | В xmlParameters указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg) | ||
Получить информацию о продавце (местоположение, рейтинг и т.п.) | или | В vendorId указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg). Рейтинг продавца в нашем АПИ - Level В blockList указываем имя продавца (https://clip.otcommerce.com/files/21/99/seller.jpg). Рейтинг продавца в нашем АПИ - Level | |
Получить стоимость внутренней доставки | В block list указываем DeliveryCosts В коде ищем по словам Internaldelivery (без пробела) ℹ️ Невозможно получить стоимость внутренней доставки продукта по определенному адресу через API. Нужно установить его в админке АПИ Ключа. | ||
Сортировка товаров провайдера по убыванию цены | BatchSearchItemsFrame | Пример в документации | В xmlParameters указываем провайдера, ID категории и порядок сортировки (например, Таобао, otc-1, по убыванию): <SearchItemsParameters><Provider>Taobao</Provider><CategoryId>otc-1</CategoryId><OrderBy>Price:Desc</OrderBy></SearchItemsParameters> |
Сортировка товаров провайдера по возрастанию цены | BatchSearchItemsFrame | Пример в документации | В xmlParameters указываем провайдера, ID категории и порядок сортировки (например, Таобао, otc-1, по возрастанию): <SearchItemsParameters><Provider>Taobao</Provider><CategoryId>otc-1</CategoryId><OrderBy>Price:Asc</OrderBy></SearchItemsParameters> |
Получить языки для АПИ Ключа | ℹ️ В стоимость АПИ Ключей K0 Basic, K1 Standard и K2 Advanced входит только 1 язык. Чтобы подключить дополнительный язык, необходимо подключение платного модуля «Мультиязычность». Цена ℹ️ Для Ключа K3 Enterprise доступно неограниченное количество языков. |
...