Проверка доступности модулей поиска по фото
Используемый метод 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> |
Обратите внимание, что при отсутствии провайдера или модуля поиска по фото для данного провайдера примеры работать не будут.