Неполная информация о товарах

Ключ АПИ ОТ позволяет передавать на сайт каталог и поиск товаров с различных популярных маркетплейсов, а также информацию о товарах, необходимые для организации их продажи покупателям.

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

Мы используем разные способы получения информации с маркетплейсов от АПИ Таобао до собственных поисковых методов. После получения информации с маркетплейса все товары попадают в базу данных OpenTrade Commerce. И уже оттуда передаются в интернет-магазины, использующие Ключ АПИ ОТ. Подробнее о работе нашей системы можно узнать тут.

Поэтому получая информацию о товарах из разных источников, у нас есть возможность показывать разные товары с полной и неполной информацией.

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

Для того, чтобы сделать неполный запрос, нужно указать в АПИ, что нам достаточно любой информации о товаре. Обязательные параметры для неполного запроса о товаре включает идентификатор, изображение и название. Указать это можно в специальном параметре itemParameters любого метода получения товара, например в BatchGetItemFullInfo. Подробнее можно ознакомиться в документации по работе с АПИ.

Исключение! Из-за того, что информация о ценах часто недоступна для провайдера JD. Для него есть специальная настройка. В зависимости от нее цена может быть обязательным или не обязательным параметром для товаров JD.

В нашей системе подключено много разных маркетплейсов или товарных провайдеров. Для каждого из них мы получаем разную информацию. Где-то может отсутствовать продавец, где-то цена. Но товары с неполной информацией все равно можно показать покупателям.

Если разрешить показ неполной информации в АПИ и есть все нужные параметры (идентификатор, изображение и название), но нет цены, то товар будет показываться в интернет-магазине, но будет запрещен к продаже. 

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

Учет вызовов для запросов с неполной информацией

При совершении запроса неполной информации о товаре в системе будет выдаваться ошибка, если отсутствует какой-либо обязательный параметр. Такой запрос будет бесплатным, так как пользователь не получил никакой информации о товаре.

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

При неполном запросе информации о товаре наличие какой-либо еще информации, помимо обязательных параметров, непредсказуемо. 

Запрос полной информации о товаре

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

Если в запросе разрешено получение неполных товаров, но в нашей системе не будет информации о товаре, мы его не покажем. То такой запрос также будет бесплатным. При этом наша система в приоритетном режиме получит всю доступную информацию о товаре, и при следующем запросе этого товара в течение 10-30 секунд он будет показан. Такой запрос уже будет платным.

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

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