Перейти к концу метаданных
Переход к началу метаданных

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

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

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

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

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

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

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

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

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

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

  1. Работать на языке программирования, который используется у вас на сайте.
  2. Уметь работать с SOAP (или посылать http-запросы).
  3. Разбирать 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']);

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

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

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

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


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

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

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

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

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

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

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

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

Как работает кэш?

У товаров кэш (сам товар, карточка, цена, скидки и т. п.) — 1 сутки.
У поиска — 2 суток.

Сутки считаются с момента обновления/появления/просмотра, а не календарные. Например, некто открыл первый раз товар на сайте в 10 утра. Значит товар останется в таком виде до следующих 10 утра, сколько бы и кто бы его не открывал (другой посетитель сайта или владелец или кто-то еще).

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

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


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

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

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

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

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

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

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

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

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

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

BatchGetItemFullInfo (http://docs.otapi.net/ru/Documentations/Index/21)

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

BatchSearchItemsFrame 

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

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

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=opendemo&language=en&xmlParameters=%3CSearchItemsParameters%3E%3CCategoryId%3E30%3C

 

<VendorScore>18</VendorScore>

 

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


  • No labels