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

Используемый метод GetProviderInfoList.

В каждом провайдере, который поддерживает поиск по фото, есть блок ImageSearch. Внутри блока ImageSearch  два свойства IsAvailable и IsEnabled.

  • Если блок есть и IsAvailable равно true, то в данном провайдере в принципе доступен поиск по фото.
  • Если при этом IsEnabled равно false, то модуль не включен для вашего ключа.
  • Если IsEnabled равно true, то модуль включен для вашего ключа, и вы можете выполнять поиск по фото.

Настройка

Когда модуль куплен, необходимо активировать новые способы поиска для каждого провайдера.

Заходим по адресу: http://open-demo.otcommerce.com/ik.php

Вводим свой ключ:

Затем вводим логин и пароль, которые были получены вместе с ключом:

Далее следуем инструкции, описанной в документации пользователей «Поиск товаров → Добавляем активные способы поиска»

Поиск по фото

Сам поиск по фото производится обычными стандартными методами BatchSearchItemsFrame и SearchItemsFrame, с использованием параметров ImageUrl или ImageFileId. Подробнее о них на странице документации «Поиск (OT API)» в таблице «Способы и условия поиска».

Если у вас более одного провайдера, рекомендуется так же явно указать в параметрах поиска конкретного провайдера, по которому ведется поиск по фото.

Загрузка файлов в OT CDN для поиска по фото

Когда нет возможности указать напрямую url фотографии, например в мобильном приложении, то можно загрузить фотографию в нашу систему.

Для этого нужно:

1. Получить идентификатор и адрес загрузки файла методом http://docs.otapi.net/ru/Documentations/Method?name=GetFileUploadUrl, в качестве типа файла нужно указать Image.
2. Отправить содержимое-файла (фотографии) POST-запросом на полученный URL из пункта 1 (например, при помощи curl)
3. После успешной загрузки файла получить информацию о нем по идентификатору из пункта 1 методом http://docs.otapi.net/ru/Documentations/Method?name=GetFileInfo. Проверить статус файла, что он успешно закачан.
4. Использовать идентификатор файла в тех местах, где это нужно, например ImageFileId в параметрах поиска товара.

Примеры

Название примераЗначение xmlParameters
Поиск по фото по Таобао
<SearchItemsParameters>
  <Provider>Taobao</Provider>
  <ImageUrl>https://www.google.ru/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png</ImageUrl>
</SearchItemsParameters>
Поиск по фото по 1688
<SearchItemsParameters>
  <Provider>Alibaba1688</Provider>
  <ImageUrl>https://www.google.ru/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png</ImageUrl>
</SearchItemsParameters>

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

  • Нет меток