Предпринимателям

Какие ограничения тестового ключа?

Лимит вызовов 5000/сутки.
Только один тип поиска по Таобао.
Отсутствие картинок конфигураций и веса.
Никаких дополнительных модулей.
Отсутствие гарантии сохранности настроек.

Как получить тестовый ключ?

Для получения тестового ключа обратитесь к операторам на сайте https://otcommerce.com/ru/ или к менеджерам в вашем скайп чате.

Как начать работу с ключом?

Иметь свой сайт (интернет-магазин) или домен + хостинг.
Приобрести ключ.
Разработать модуль для работы с ключом (самостоятельно или с привлечением программиста).

Зачем нужен программист?

Если у вас есть квалификация и знания о том, как подготовить свой сайт для работы со сторонним API, то услуги программиста вам не понадобятся. Вполне хватит документации. В этом случае, наличие программиста просто сэкономит ваше личное время и ускорит запуск сайта.

Если навыка в программировании у вас нет, тогда программист сделает все необходимые настройки для работы с ключом.

Оценить свои знания вы сможете по вопросам для разработчиков, а также документации. Если будет понятно о чем там говорится, значит программист вам необязателен.

Что должен уметь программист, чтобы справиться с работой?

Работать на языке программирования, который используется у вас на сайте.
Уметь работать с SOAP (или посылать http-запросы).
Разбирать xml.

Это минимальные навыки, при наличии которых, программист справится с работой.

Есть примеры работы вашего ключа?

Отличный пример использования ключа OT API сайт http://cn.shopotam.ru/. Ключ используется для работы с товарами Таобао.

Что такое вызовы и сколько мне их надо? Как выбрать ключ?

Все данные с маркетплейсов (товары, цены, описания и т.д.) ваш сайт получает через сервисы Платформы ОТ.

Вызов — это каждое обращение к этим сервисам. Например, когда посетитель сайта открывает карточку товара, сайт запрашивает информацию об этом товаре, счетчик Платформы определяет это как один вызов.

Если будем считать, что в среднем посетитель сайта смотрит по 10-15 страниц в сутки, то выбрать ключ очень просто:

если у вас посещаемость сайта до 500-700 человек, тогда подойдет Ключ К1 (при условии, что вам не нужна техподдержка и консультации по API). Если посещаемость приближается к 1000 человек в сутки, то этого ключа может не хватить.
для посещаемости не выше 1200-1300 человек в сутки подойдет ключ К2, но если посещаемость приближается к 1400, то лучше взять К3 без лимита вызовов.

Стоимость и другую информацию по ключам, можно посмотреть тут: http://key.otcommerce.com/ru/service-payments-rates

Внимание! Количество вызовов может зависеть от настроек, которые задал программист. Например, если будет задача подгружать не только первый товар, который смотрит клиент, а еще следующие 2 (так как статистика сайта у вас показала, что клиенты смотрят подряд первые 2-3 товара), то количество вызовов будет больше, чем в примере.

Разработчикам

Как примерно выглядит библиотека?

Например получение заказов для юзеров 1,2,3

include ('otapilib.php');
 $otapilib = new OTAPIlib();

$data = $otapilib->AuthenticateInstanceOperator($login, $pass);
 if (isset($data['SessionId'])) {
 $sid = (string)$data['SessionId'];
 $_SESSION['sid'] = (string)$data['SessionId'];
 $GLOBALS['sid'] = (string)$data['SessionId'];
 } else {
 die(""Auth fail"");
 }
 
 $userIds = array(1,2,3);
 $xml = new SimpleXMLElement('<OrderSearchParameters></OrderSearchParameters>');
 $xml->addChild('UserIdDelimitedList', implode(';', $userIds));
 $xml->addChild('OrderBy', implode(';', array('CreationDate:Asc', 'TotalAmount:desc')));
 $xml = trim(str_replace('<?xml version=""1.0""?>', '', $xml->asXML()));
 
 $limit = 500;
 $offset = 0;
 $orders = $otapilib->SearchOrders($sid, $xml, $offset, $limit);
 var_dump($orders['Content']);

Есть примеры xmlParameters?

По этой ссылке можно посмотреть примеры xmlParameters http://docs.otapi.net/ru/Documentations/Method?name=BatchSearchItemsFrame

Какое время обработки запросов вашим сервисом?

1-4 секунды мимо кэша, 0.05-0.4 секунды при попадании в кэш. Разброс потому, что не всегда внутри лишь 1 вызов Таобао.

Среднее время вызова OT API в целом - 500-600 мс.

Сколько товаров можно запросить за одно соединение?

За эту величину отвечает метод GetProviderSearchMethodInfoList, там есть значение MaximumFrameSize.

По умолчанию — 200

Где можно смотреть статистику вызовов?

Статистика вызовов находится по адресу: http://docs.otapi.net/ru/Documentations/Index/18

Также возможно получить отчет по вызовам в админке вашего Ключа:

Имеет ли значение для работы на ваших ключах на каком из языком написан наш сайт?

Нет, не имеет. Вы можете интегрировать ключ в любую CMS (Content management system).

Насколько часто обновляется информация в вашей базе о дереве категорий?

Если говорить о таобаовском, то 2 недели.
Если о вашем личном, то каким загрузите/построите, таким и будет, пока сами не поменяете.

Как можно понять в http://docs.otapi.net/ru/ какие методы завязаны на ваш сайт\админку ключа, и какие на непосредственно работу с Таобао?

Все методы, которые платные (помечены значком $), потенциально работают с провайдером, в данном случае с Таобао:

Откуда брать цену со скидкой?

В поиске Price (например, метод BatchSearchItemsFrame) — базовая цена, PromotionPrice (если есть) — скидочная.

В методе BatchGetItemFullInfo отдельный раздел Promotions со списком скидок, который необходимо запрашивать в параметре blockList.

Здесь же выдаются цены по диапазонам.

Основные методы

Поиск по слову

<SearchItemsParameters><ItemTitle>слово</ItemTitle></SearchItemsParameters>

если такое передать в xmlParameters, то будет поиск по слову

Отзывы

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

http://docs.otapi.net/ru/Documentations/Method?name=SearchReviewedItems

Пример получения отзывов к товару

http://otapi.net/OtapiWebService2.asmx/SearchItemReviews?instanceKey=IK&language=en&sessionId=SESSION&xmlSearchParameters=<SearchParameters>%20%20%20<ItemId>522226153057<%2FItemId>%20<%2FSearchParameters>&framePosition=0&frameSize=20

надо подставить IK и SESSION свои только

framePosition и frameSize отвечают с какой позиции и сколько записей выводить

В xmlSearchParameters передается http://docs.otapi.net/en/Documentations/Type?name=OtapiSearchItemReviewParameters
itemId

Дерево категорий

GetRootCategoryInfoList / GetCategorySubcategoryInfoList (http://docs.otapi.net/ru/Documentations/Index/35)

Запросив информацию о товаре методом http://docs.otapi.net/en/Documentations/Method?name=BatchGetItemFullInfo можно передать дополнительный параметр RootPath - cписок родительских категорий (путь к корню). Каждая категория из узла RootPath содержит информацию о категории http://docs.otapi.net/ru/Documentations/Type?name=OtapiCategory и в частности узел name, который является названием категории.

Нарисовать корневое меню категорий до третьего уровня легко: http://docs.otapi.net/ru/Documentations/Method?name=GetThreeLevelRootCategoryInfoList

Если нужно глубже - то уже при наведении на каждую категорию запрашивать http://docs.otapi.net/ru/Documentations/Method?name=GetCategorySubcategoryInfoList
Глубже трех категорий редко кто делает.

Информация о товаре

BatchGetItemFullInfo - получение полной информации о товаре, одновременно с дополнительными блоками

Укажите Description,DeliveryCosts,Promotions в параметр blockList: http://prntscr.com/ofrdxg

Подборки товаров
SearchRatingListItems

параметры
Best - Рекомендованные - то что заполнили в админке
Popular - популярные, те которые пользователи чаще всего просматривали
Recommend - не используется.
Last - последние открытые
Category - категория, созданная с помощью модуля Селектор из отобранных товаров.

Список товаров

BatchSearchItemsFrame

В помощь GetProviderSearchMethodInfoList — там информация о допустимых параметрах поиска товаров.

Получение списка брендов с идентификаторами

http://docs.otapi.net/en/Documentations/Index/40

GetBrandInfoFullList Получение полного списка брендов, включая скрытые

GetBrandInfoList Получение списка брендов

GetBrandInfoListFrame Получение частичного списка брендов

Получение информации о весе, размере, цветах, скидках

BatchGetItemFullInfo

Поиск по всем товарам (таобао и tmall) — универсальный

BatchSearchItemsFrame — глобальный (универсальный) поиск товаров, одновременно с дополнительными блоками. Работает по Таобао несколькими способами. В качестве основного — Tmall.

Описание по блокам:

SubCategories - сразу получить подкатегории, если поиск был по категории

SearchProperties - сразу получить фильтры по характеристикам/свойствам

RootPath - сразу получить путь к корню, если поиск был по категории

Vendor - сразу получить информацию о продавце, если поиск был по продавцу

Brand - сразу получить информацию о бренде, если поиск был по бренду

Category - сразу получить информацию о категории, если поиск был по категории

HintCategories — сразу получить подходящие по названию категории, если поиск был по тексту

AvailableSearchMethods — сразу получить список подходящих под данные параметры способов поиска, и всю информацию по ним

Поиск по всем товарам (Таобао и tmall) — расширенный

Пробуйте по <SearchMethod>Extended</SearchMethod>

Получение информации и продажах и рейтинге продавца

BatchSearchItemsFrame и BatchGetItemFullInfo

Количество продаж в FeaturedValues (если есть такая информация по продавцу)

Рейтинг продавца в VendorRating

http://otapi.net/OtapiWebService2.asmx/SearchItemsFrame?instanceKey=test_Key&language=en&xmlParameters=%3CSearchItemsParameters%3E%3CCategoryId%3E30%3C

по этой ссылке рейтинг от 1 до 20 (1 - минимальный, 20 - максимальный)

Вес 1688

Вес берется из узла ActualWeightInfo (метод http://docs.otapi.net/ru/Documentations/Method?name=BatchGetItemFullInfo). Значение в данном поле берется из настроек, их можно менять в админке по ссылке, которую представит менеджер в скайп чате.

GET/POST запросы

Все запросы к api нужно отправлять методом POST. GET метод используется только для режима отладки и для запросов с коротким набором параметров. Необходимо отправлять запрос ajax (используя метод POST) и получайте ответ. GET может принимать только адрес, включая все параметры, длиной максимум до 2048. POST помимо параметров в адресе еще имеет содержимое, где тоже можно отправлять параметры и длина не ограничена. Это стандарты http, которым следуют все веб-сервера, включая и наши.

Частичный импорт каталога

Частичный импорт не гарантирует сохранность идентификаторов, так как каталог уже чем-то наполнен. Метод частичного импорта возвращает список соответствий, какой идентификатор был в файле, и какой стал на деле.

Вопросы и Ответы по Ключам ОТ API