Главная > Документация uAPI > Модуль "Интернет-магазин", товары
 

[GET] Список всех товаров


Параметр page=allgoods имитирует работу веб-страницы /shop/all, то есть выдает все товары. Все отдаваевымые товары разделены постранично и содержат максильно полную информацию

Дополнительные параметры запроса

  • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
  • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
    • Возможные значения:
    • id – по ID
    • art – по артикулу
    • brand – по производителю
    • name – по названию (значение по умолчанию)
    • price – по цене
    • warr – по гарантии
    • weight – по весу
    • added_time – по дате добавления товара
    • modified_time – по дате изменения товара
    • num_com – по количеству комментариев
    • rating – по рейтингу
    • ordered – по количеству оформлений в заказах
    • views – по количеству просмотров
    • solds – по количеству продаж
    • other# – по дополнительному полю 1-9
  • order=SORT_MODE – [Строка] – режим сортировки
    • Возможные значения:
    • asc – по возрастанию (значение по умолчанию)
    • desc – по убыванию
  • f_art=BASE64_ARTICULE – [Строка] – Фильтр по артикулу (значение должно быть в Base64) *
  • f_brand=BASE64_BRAND – [Строка] – Фильтр по производителю (значение должно быть в Base64) *
  • f_name=BASE64_NAME – [Строка] – Фильтр по названию (значение должно быть в Base64) *
  • f_warr=BASE64_WARR – [Строка] – Фильтр по гарантии (значение должно быть в Base64) *
  • f_weight=BASE64_WEIGHT – [Строка] – Фильтр по весу (значение должно быть в Base64) *
  • f_stock=BASE64_STOCK – [Строка] – Фильтр по остатку (значение должно быть в Base64) *
  • f_status=BASE64_STATUS – [Строка] – Фильтр по статусу (значение должно быть в Base64) *
  • f_price=BASE64_PRICE – [Строка] – Фильтр по по цене (значение должно быть в Base64. В качестве базовой строки для формирования Base64-значения должна браться строка формата '<МИН_ЦЕНА>|<МАКС_ЦЕНА>|<КОД_ВАЛЮТЫ>') *
  • f_other#=BASE64_OTHER – [Строка] – фильтр по дополнительному полю 1-9 (значение должно быть в Base64) *
  • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
  • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
* Учитываются только те фильтры, которые разрешены в настройках магазина

В случае ошибки

{ 'error' => { ERROR_DATA } }

В случае успешного ответа

{ 'success': { CATEGORY_DATA GOODS_LIST } }

Расшифровка ответа

  • CATEGORY_DATA – Cекция с данными категории
    • Содержит поля:
    • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
    • filters - FILTERS_DATA – секция с данными по фильтрам товаров категории
    • paginator – секция с данными по пагинатору выборки. cur_page - номер текущей страницы выборки, заданный параметром pnum. num_pages - количество страниц выборки.
    • duplicate – признак, что запрос был отправлен на дублирующуюся по URL страницу (например, /category;0 /category;1)
    • goods_count – количество товаров в категории
    • meta_data – META-DATA - секция с META-данными категории
  • sort - SORT_DATA – Cекция с данными по режимах сортировки товаров категории
    • Содержит поля:
    • sort – поле по которому был отсортирован список товаров
    • order – использованный режим сортировки
    • slist – секция с подписями к полям сортировки. field - поле сортировки. name - подпись к полю
  • FILTERS_DATA – секция с данными по фильтрам товаров категории
    • Содержит поля:
    • fdata – набор данных по фильтрам (все возможные значения фильтра, мин/макс значение для фильтра по цене, позиция каждого значения фильтра в блоке значений и количество товаров подпадающих под каждое значение фильтра).
    • filters – значения примененых фильтров. for_uri - содержит строку с фильтрами, если включена опция “Дублировать фильтры товаров в адресной строке
  • META-DATA – секция с META-данными категории
    • Содержит поля:
    • meta_title – содержимое TITLE-тега
    • meta_description – содержимое тега <meta name="description" content="..." />
  • GOODS_LIST – секция со списком товаров категории. Данная секция содержит список подсекций с данными по каждому выбранному товару. ID подсекции - порядковый номер подсекции в списке подсекций
    • Содержит поля:
    • entry_id – ID товара
    • entry_title – наименование товара
    • entry_cat – ENTRY_CAT - секция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
    • entry_cats – ENTRY_CATS - секция с дополнительными категориями товара
    • entry_brand – значение поля “Производитель”
    • entry_brief – краткое описание товара
    • entry_description – описание товара
    • entry_photo – ENTRY_PHOTO - секция с изображениями товара
    • entry_hgu – ЧПУ товара
    • entry_shop_url – URL товара в магазине
    • entry_type – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
    • entry_price – цена товара
    • entry_price_in – входящая цена товара
    • entry_price_old – старая цена товара
    • entry_price_vat – цена товара с НДС (если в настройках магазина включен расчет НДС)
    • entry_price_vat_eval – цена товара без НДС (если в настройках магазина включен расчет НДС)
    • entry_unit – значение поля “Единица”
    • entry_weight – вес товара
    • entry_art_no – значение поля “Артикул”
    • entry_stock – остаток товара
    • entry_warr – значение поля “Гарантия”
    • entry_others – секция со значениями дополнительных полей товара. Количество элеметов секции зависит от количества дополнительных полей товара, установленного в настройках магазина.
    • entry_options – ENTRY_OPTIONS - секция с опциями товара
    • entry_is_in_discount – признак, что товар включается в расчет скидок
    • entry_is_hidden – признак, что товар скрыт
    • entry_is_in_basket – признак, что товар добавлен в корзину текущего пользователя
    • entry_is_in_wishlist – признак, что товар добавлен в список желаний текущего пользователя
    • entry_rating – ENTRY_RATING - секция с данными по рейтингу товара
    • entry_views – количество просмотров товара
    • entry_solds – количество продаж товара
    • entry_ordered – количество заказов, оформленных с данным товаром
    • num_com – оличество комментариев товара
    • entry_file_size – размер прикрепленного к товару файла
    • entry_add_uid – ID пользователя, добавившего товар
    • entry_add_user – логин пользователя, добавившего товар
    • entry_added_time – время добавления товара
    • entry_modified_time – время последнего изменения товара
  • ENTRY_CAT – екция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
  • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
    • Содержит поля:
    • id – ID товара
    • pid – ID родительской категории
    • name – название категории товара
    • pname – название родительской категории товара
    • url – URI категории относительно корня магазина
    • purl – URI родительской категории относительно корня магазина
  • ENTRY_CATS – секция с дополнительными категориями товара
    • Содержит поля:
    • cats – подсекция с данными дополнительных категорий товара. id - ID категории. url - URI категории относительно корня магазина. name - название категории.
    • num_cats – количество дополнительных категорий товара
  • ENTRY_PHOTO – секция с изображениями товара
    • Содержит поля:
    • num_photos – количество изображений
    • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
    • others_photo – секциями с данными других изображений товара (набор полей аналогичен секции def_photo)
  • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
  • GETSHOP /uapi/shop/request?page=allgoods
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/request', array( 'page' => 'allgoods' )); print_r($response); //Получаем ответ ?>
    { "success":{ "sort":{ "sort":"added_time", "order":"desc", "slist":[ { "name":"Наименование", "field":"name" }, { "name":"Цена", "field":"price" }, { "name":"Дата добавления", "field":"added_time" } ] }, "duplicate":0, "meta_data":{ "META_DESCRIPTION":"Все товары. Фон рабочего стола uCoz, Красивый UIN", "META_TITLE":"" }, "goods_list":{ "1":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":3 }, "entry_brief":"Если вам нужен красивый и запоминающийся UIN, этот товар для Вас.\r Данный товар имеет тип \"Электронный код\". Это означает, что пользователь после оплаты получит код, указанный при создании товара. Один код может быть куплен один раз.", "entry_price_old":{ "price_raw":"0.00", "price":0 }, "entry_unit":"шт.", "entry_id":"1", "entry_solds":"0", "entry_modified_time":{ "mod_wday":"Четверг", "mod_date":"05.04.2012", "mod_time":"12:13" }, "entry_cats":{ "cats":[ { "url":"digital-goods", "name":"Цифровые товары", "id":"1" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_description":"Если вам нужен красивый и запоминающийся UIN, этот товар для Вас.\nДанный товар имеет тип \"Электронный код\". Это означает, что пользователь после оплаты получит код, указанный при создании товара. Один код может быть куплен один раз.", "entry_price_in":{ "price_raw":"0.00", "price":0 }, "entry_price_vat_eval":{ "price_raw":10, "price":"$10.00" }, "entry_views":"1", "num_com":"0", "entry_title":"Красивый UIN", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"", "entry_added_time":{ "add_date":"05.04.2012", "add_time":"12:13", "add_wday":"Четверг" }, "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"0", "purl":null, "url":"digital-goods", "pname":"", "name":"Цифровые товары", "id":"1" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":3, "entry_price":{ "price_raw":10, "price":"$10.00" }, "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"krasivyj-uin", "page_id":"allgoods", "ordered":"0", "entry_shop_url":"http://www.dmev.me/shop/1/desc/krasivyj-uin", "entry_type":"2", "entry_photo":{ "num_photos":0, "others_photo":"", "def_photo":{ "small":"http://s42.ucoz.net/img/sh/nfs.png", "photo":"http://s42.ucoz.net/img/sh/nf.png", "thumb":"http://s42.ucoz.net/img/sh/nf.png" } } }, "0":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"Не раздражающий глаза фон с иcпользованием логотипа uCoz. Товар является файлом. Пользователь получит ссылку на скачивание файла после оплаты. Ссылка перестанет быть доступна после скачивания.", "entry_price_old":{ "price_raw":5, "price":"$5.00" }, "entry_unit":"шт.", "entry_id":"2", "entry_solds":"0", "entry_modified_time":{ "mod_wday":"Четверг", "mod_date":"05.04.2012", "mod_time":"12:19" }, "entry_cats":{ "cats":[ { "url":"digital-goods", "name":"Цифровые товары", "id":"1" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_description":"Не раздражающий глаза фон с ипользованием логотипа uCoz. Товар является файлом. Пользователь получит ссылку на скачивание файла после оплаты. Ссылка перестанет быть доступна после скачивания.", "entry_price_in":{ "price_raw":"0.00", "price":0 }, "entry_price_vat_eval":{ "price_raw":2, "price":"$2.00" }, "entry_views":"1", "num_com":"0", "entry_title":"Фон рабочего стола uCoz", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"", "entry_added_time":{ "add_date":"05.04.2012", "add_time":"12:19", "add_wday":"Четверг" }, "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"0", "purl":null, "url":"digital-goods", "pname":"", "name":"Цифровые товары", "id":"1" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":"20.2Kb", "entry_price":{ "price_raw":2, "price":"$2.00" }, "entry_brand":"uCoz", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"fon-rabochego-stola-ucoz", "page_id":"allgoods", "ordered":"0", "entry_shop_url":"http://www.dmev.me/shop/2/desc/fon-rabochego-stola-ucoz", "entry_type":"1", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://www.dmev.me/_sh/00/2s.jpg", "photo":"http://www.dmev.me/_sh/00/2.jpg", "thumb":"http://www.dmev.me/_sh/00/2m.jpg" } } } }, "filters":{ "fdata":{ "brand":{ "uCoz":{ "pos":1, "cnt":"1" } } }, "filters":{ "for_uri":"" } }, "goods_count":"2", "paginator":{ "cur_page":1, "num_pages":1 } } }
     

    [GET] Мои желания (товары)


    Параметр page=wishlist имитирует работу веб-страницы /shop/wishlist, то есть отдают все товары, где вы нажали на кнопку "Добавить в список желаний". Все отдаваевымые товары разделены постранично и содержат максильно полную информацию

    Дополнительные параметры запроса

    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Возможные значения:
      • id – по ID
      • art – по артикулу
      • brand – по производителю
      • name – по названию (значение по умолчанию)
      • price – по цене
      • warr – по гарантии
      • weight – по весу
      • added_time – по дате добавления товара
      • modified_time – по дате изменения товара
      • num_com – по количеству комментариев
      • rating – по рейтингу
      • ordered – по количеству оформлений в заказах
      • views – по количеству просмотров
      • solds – по количеству продаж
      • other# – по дополнительному полю 1-9
    • order=SORT_MODE – [Строка] – режим сортировки
      • Возможные значения:
      • asc – по возрастанию (значение по умолчанию)
      • desc – по убыванию
    • f_art=BASE64_ARTICULE – [Строка] – Фильтр по артикулу (значение должно быть в Base64) *
    • f_brand=BASE64_BRAND – [Строка] – Фильтр по производителю (значение должно быть в Base64) *
    • f_name=BASE64_NAME – [Строка] – Фильтр по названию (значение должно быть в Base64) *
    • f_warr=BASE64_WARR – [Строка] – Фильтр по гарантии (значение должно быть в Base64) *
    • f_weight=BASE64_WEIGHT – [Строка] – Фильтр по весу (значение должно быть в Base64) *
    • f_stock=BASE64_STOCK – [Строка] – Фильтр по остатку (значение должно быть в Base64) *
    • f_status=BASE64_STATUS – [Строка] – Фильтр по статусу (значение должно быть в Base64) *
    • f_price=BASE64_PRICE – [Строка] – Фильтр по по цене (значение должно быть в Base64. В качестве базовой строки для формирования Base64-значения должна браться строка формата '<МИН_ЦЕНА>|<МАКС_ЦЕНА>|<КОД_ВАЛЮТЫ>') *
    • f_other#=BASE64_OTHER – [Строка] – фильтр по дополнительному полю 1-9 (значение должно быть в Base64) *
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    * Учитываются только те фильтры, которые разрешены в настройках магазина

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { CATEGORY_DATA GOODS_LIST } }

    Расшифровка ответа

    • CATEGORY_DATA – Cекция с данными категории
      • Содержит поля:
      • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
      • filters - FILTERS_DATA – секция с данными по фильтрам товаров категории
      • paginator – секция с данными по пагинатору выборки. cur_page - номер текущей страницы выборки, заданный параметром pnum. num_pages - количество страниц выборки.
      • duplicate – признак, что запрос был отправлен на дублирующуюся по URL страницу (например, /category;0 /category;1)
      • goods_count – количество товаров в категории
      • meta_data – META-DATA - секция с META-данными категории
    • sort - SORT_DATA – Cекция с данными по режимах сортировки товаров категории
      • Содержит поля:
      • sort – поле по которому был отсортирован список товаров
      • order – использованный режим сортировки
      • slist – секция с подписями к полям сортировки. field - поле сортировки. name - подпись к полю
    • FILTERS_DATA – секция с данными по фильтрам товаров категории
      • Содержит поля:
      • fdata – набор данных по фильтрам (все возможные значения фильтра, мин/макс значение для фильтра по цене, позиция каждого значения фильтра в блоке значений и количество товаров подпадающих под каждое значение фильтра).
      • filters – значения примененых фильтров. for_uri - содержит строку с фильтрами, если включена опция “Дублировать фильтры товаров в адресной строке
    • META-DATA – секция с META-данными категории
      • Содержит поля:
      • meta_title – содержимое TITLE-тега
      • meta_description – содержимое тега <meta name="description" content="..." />
    • GOODS_LIST – секция со списком товаров категории. Данная секция содержит список подсекций с данными по каждому выбранному товару. ID подсекции - порядковый номер подсекции в списке подсекций
      • Содержит поля:
      • entry_id – ID товара
      • entry_title – наименование товара
      • entry_cat – ENTRY_CAT - секция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
      • entry_cats – ENTRY_CATS - секция с дополнительными категориями товара
      • entry_brand – значение поля “Производитель”
      • entry_brief – краткое описание товара
      • entry_description – описание товара
      • entry_photo – ENTRY_PHOTO - секция с изображениями товара
      • entry_hgu – ЧПУ товара
      • entry_shop_url – URL товара в магазине
      • entry_type – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
      • entry_price – цена товара
      • entry_price_in – входящая цена товара
      • entry_price_old – старая цена товара
      • entry_price_vat – цена товара с НДС (если в настройках магазина включен расчет НДС)
      • entry_price_vat_eval – цена товара без НДС (если в настройках магазина включен расчет НДС)
      • entry_unit – значение поля “Единица”
      • entry_weight – вес товара
      • entry_art_no – значение поля “Артикул”
      • entry_stock – остаток товара
      • entry_warr – значение поля “Гарантия”
      • entry_others – секция со значениями дополнительных полей товара. Количество элеметов секции зависит от количества дополнительных полей товара, установленного в настройках магазина.
      • entry_options – ENTRY_OPTIONS - секция с опциями товара
      • entry_is_in_discount – признак, что товар включается в расчет скидок
      • entry_is_hidden – признак, что товар скрыт
      • entry_is_in_basket – признак, что товар добавлен в корзину текущего пользователя
      • entry_is_in_wishlist – признак, что товар добавлен в список желаний текущего пользователя
      • entry_rating – ENTRY_RATING - секция с данными по рейтингу товара
      • entry_views – количество просмотров товара
      • entry_solds – количество продаж товара
      • entry_ordered – количество заказов, оформленных с данным товаром
      • num_com – оличество комментариев товара
      • entry_file_size – размер прикрепленного к товару файла
      • entry_add_uid – ID пользователя, добавившего товар
      • entry_add_user – логин пользователя, добавившего товар
      • entry_added_time – время добавления товара
      • entry_modified_time – время последнего изменения товара
    • ENTRY_CAT – екция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Содержит поля:
      • id – ID товара
      • pid – ID родительской категории
      • name – название категории товара
      • pname – название родительской категории товара
      • url – URI категории относительно корня магазина
      • purl – URI родительской категории относительно корня магазина
    • ENTRY_CATS – секция с дополнительными категориями товара
      • Содержит поля:
      • cats – подсекция с данными дополнительных категорий товара. id - ID категории. url - URI категории относительно корня магазина. name - название категории.
      • num_cats – количество дополнительных категорий товара
    • ENTRY_PHOTO – секция с изображениями товара
      • Содержит поля:
      • num_photos – количество изображений
      • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
      • others_photo – секциями с данными других изображений товара (набор полей аналогичен секции def_photo)
  • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
  • GETSHOP /uapi/shop/request?page=wishlist
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/request', array( 'page' => 'wishlist' )); print_r($response); //Получаем ответ ?>
    { "success":{ "sort":{ "sort":"added_time", "order":"desc", "slist":[ { "name":"Наименование", "field":"name" }, { "name":"Цена", "field":"price" }, { "name":"Дата добавления", "field":"added_time" } ] }, "duplicate":0, "meta_data":{ "META_DESCRIPTION":"Товары uAPI. Новые очки от Recon Transcend", "META_TITLE":"" }, "goods_list":{ "0":{ "entry_is_in_discount":1, "entry_weight":{ "weight":"300.00", "weight_raw":"300.0000" }, "entry_stock":{ "stock_total":"10", "stock":"10" }, "entry_brief":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения. Очки отображают в реальном времени скорость, высоту, общее...", "entry_price_old":{ "price_raw":340, "price":"340.00$" }, "entry_unit":"Размер", "entry_id":"5", "entry_solds":"0", "entry_modified_time":"1333614702", "entry_cats":{ "cats":[ { "url":"gadjets/sport", "name":"Спорт", "id":"6" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"320.00", "price":"320.00$" }, "entry_description":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения.\n\nОчки отображают в реальном времени скорость, высоту, общее расстояние, количество ваших спусков, температуру и время. Ваши данные сохраняются во встроенной памяти, после чего вы можете сбросить их на свой компьютер и посмотреть свои достижения на Google Maps. Очки оснащены различными датчиками, которые фиксируют окружающую информацию. Управление осуществляется с помощью трех больших кнопок. Аккумулятор может работать автономно до 8 часов.\n\n", "entry_price_vat_eval":{ "price_raw":500, "price":"500.00$" }, "entry_views":"3", "num_com":"0", "entry_title":"Новые очки от Recon Transcend", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"12мес", "entry_added_time":"1333614645", "entry_art_no":"32165468-6898", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/sport", "pname":"Гаджеты", "name":"Спорт", "id":"6" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":500, "price":"500.00$" }, "entry_ordered":"0", "entry_brand":"Transcend", "entry_others":{ "other3":"ЗУ в комплект не входит", "other2":"Не бьются", "other1":"20x20x20" }, "entry_hgu":"sport-glasses", "entry_shop_url":"http://yoursite.ucoz.ru/shop/5/desc/sport-glasses", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/5s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/5.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/5m.jpg" } } } }, "filters":{ "fdata":{ "brand":{ "Transcend":{ "pos":1, "cnt":"1" } } }, "filters":{ "for_uri":"" } }, "goods_count":"1", "paginator":{ "cur_page":1, "num_pages":1 } } }
     

    [GET] Товары категории


    Получение всех товаров категории. Имитация перехода на страницу категории в веб-версии, где выводятся все товары этой выбранной категории

    Дополнительные параметры запроса

    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Возможные значения:
      • id – по ID
      • art – по артикулу
      • brand – по производителю
      • name – по названию (значение по умолчанию)
      • price – по цене
      • warr – по гарантии
      • weight – по весу
      • added_time – по дате добавления товара
      • modified_time – по дате изменения товара
      • num_com – по количеству комментариев
      • rating – по рейтингу
      • ordered – по количеству оформлений в заказах
      • views – по количеству просмотров
      • solds – по количеству продаж
      • other# – по дополнительному полю 1-9
    • order=SORT_MODE – [Строка] – режим сортировки
      • Возможные значения:
      • asc – по возрастанию (значение по умолчанию)
      • desc – по убыванию
    • f_art=BASE64_ARTICULE – [Строка] – Фильтр по артикулу (значение должно быть в Base64) *
    • f_brand=BASE64_BRAND – [Строка] – Фильтр по производителю (значение должно быть в Base64) *
    • f_name=BASE64_NAME – [Строка] – Фильтр по названию (значение должно быть в Base64) *
    • f_warr=BASE64_WARR – [Строка] – Фильтр по гарантии (значение должно быть в Base64) *
    • f_weight=BASE64_WEIGHT – [Строка] – Фильтр по весу (значение должно быть в Base64) *
    • f_stock=NUMBER – [Число] – Фильтр по остатку (значение должно быть в Base64) *
    • f_status=BASE64_STATUS – [Строка] – Фильтр по статусу (значение должно быть в Base64) *
    • f_price=BASE64_PRICE – [Строка] – Фильтр по по цене (значение должно быть в Base64. В качестве базовой строки для формирования Base64-значения должна браться строка формата '<МИН_ЦЕНА>|<МАКС_ЦЕНА>|<КОД_ВАЛЮТЫ>') *
    • f_other#=BASE64_OTHER – [Строка] – фильтр по дополнительному полю 1-9 (значение должно быть в Base64) *
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    * Учитываются только те фильтры, которые разрешены в настройках магазина

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { CATEGORY_DATA GOODS_LIST } }

    Расшифровка ответа

    • CATEGORY_DATA – Cекция с данными категории
      • Содержит поля:
      • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
      • filters - FILTERS_DATA – секция с данными по фильтрам товаров категории
      • paginator – секция с данными по пагинатору выборки. cur_page - номер текущей страницы выборки, заданный параметром pnum. num_pages - количество страниц выборки.
      • duplicate – признак, что запрос был отправлен на дублирующуюся по URL страницу (например, /category;0 /category;1)
      • goods_count – количество товаров в категории
      • meta_data – META-DATA - секция с META-данными категории
    • sort - SORT_DATA – Cекция с данными по режимах сортировки товаров категории
      • Содержит поля:
      • sort – поле по которому был отсортирован список товаров
      • order – использованный режим сортировки
      • slist – секция с подписями к полям сортировки. field - поле сортировки. name - подпись к полю
      • -
    • FILTERS_DATA – секция с данными по фильтрам товаров категории
      • Содержит поля:
      • fdata – набор данных по фильтрам (все возможные значения фильтра, мин/макс значение для фильтра по цене, позиция каждого значения фильтра в блоке значений и количество товаров подпадающих под каждое значение фильтра).
      • filters – значения примененых фильтров. for_uri - содержит строку с фильтрами, если включена опция “Дублировать фильтры товаров в адресной строке
    • META-DATA – секция с META-данными категории
      • Содержит поля:
      • meta_title – содержимое TITLE-тега
      • meta_description – содержимое тега <meta name="description" content="..." />
    • GOODS_LIST – секция со списком товаров категории. Данная секция содержит список подсекций с данными по каждому выбранному товару. ID подсекции - порядковый номер подсекции в списке подсекций
      • Содержит поля:
      • entry_id – ID товара
      • entry_title – наименование товара
      • entry_cat – ENTRY_CAT - секция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
      • entry_cats – ENTRY_CATS - секция с дополнительными категориями товара
      • entry_brand – значение поля “Производитель”
      • entry_brief – краткое описание товара
      • entry_description – описание товара
      • entry_photo – ENTRY_PHOTO - секция с изображениями товара
      • entry_hgu – ЧПУ товара
      • entry_shop_url – URL товара в магазине
      • entry_type – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
      • entry_price – цена товара
      • entry_price_in – входящая цена товара
      • entry_price_old – старая цена товара
      • entry_price_vat – цена товара с НДС (если в настройках магазина включен расчет НДС)
      • entry_price_vat_eval – цена товара без НДС (если в настройках магазина включен расчет НДС)
      • entry_unit – значение поля “Единица”
      • entry_weight – вес товара
      • entry_art_no – значение поля “Артикул”
      • entry_stock – остаток товара
      • entry_warr – значение поля “Гарантия”
      • entry_others – секция со значениями дополнительных полей товара. Количество элеметов секции зависит от количества дополнительных полей товара, установленного в настройках магазина.
      • entry_options – ENTRY_OPTIONS - секция с опциями товара
      • entry_is_in_discount – признак, что товар включается в расчет скидок
      • entry_is_hidden – признак, что товар скрыт
      • entry_is_in_basket – признак, что товар добавлен в корзину текущего пользователя
      • entry_is_in_wishlist – признак, что товар добавлен в список желаний текущего пользователя
      • entry_rating – ENTRY_RATING - секция с данными по рейтингу товара
      • entry_views – количество просмотров товара
      • entry_solds – количество продаж товара
      • entry_ordered – количество заказов, оформленных с данным товаром
      • num_com – оличество комментариев товара
      • entry_file_size – размер прикрепленного к товару файла
      • entry_add_uid – ID пользователя, добавившего товар
      • entry_add_user – логин пользователя, добавившего товар
      • entry_added_time – время добавления товара
      • entry_modified_time – время последнего изменения товара
    • ENTRY_CAT – екция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Содержит поля:
      • id – ID товара
      • pid – ID родительской категории
      • name – название категории товара
      • pname – название родительской категории товара
      • url – URI категории относительно корня магазина
      • purl – URI родительской категории относительно корня магазина
    • ENTRY_CATS – секция с дополнительными категориями товара
      • Содержит поля:
      • cats – подсекция с данными дополнительных категорий товара. id - ID категории. url - URI категории относительно корня магазина. name - название категории.
      • num_cats – количество дополнительных категорий товара
    • ENTRY_PHOTO – секция с изображениями товара
      • Содержит поля:
      • num_photos – количество изображений
      • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
      • others_photo – секциями с данными других изображений товара (набор полей аналогичен секции def_photo)
  • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
  • GETSHOP /uapi/shop/cat?cat_uri=gadjets
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/cat', array( 'cat_uri' => 'gadjets' )); print_r($response); //Получаем ответ ?>
    { "success":{ "cat_id":"2", "parent_cat":"", "cat_descr":"Необычные товары. Категория содержит подкатегории", "filters":{ "fdata":{ "brand":{ "Transcend":{ "pos":1, "cnt":"1" } } }, "filters":{ "for_uri":"" } }, "goods_count":"3", "cat_img":"http://yoursite.ucoz.ru/_sh/00/2c.png", "paginator":{ "cur_page":1, "num_pages":1 }, "cat_name":"Гаджеты", "sort":{ "sort":"name", "order":"asc", "slist":[ { "name":"Наименование", "field":"name" }, { "name":"Цена", "field":"price" }, { "name":"Дата добавления", "field":"added_time" } ] }, "duplicate":0, "goods_list":{ "1":{ "entry_is_in_discount":1, "entry_weight":{ "weight":"300.00", "weight_raw":"300.0000" }, "entry_stock":{ "stock_total":"10", "stock":"10" }, "entry_brief":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения. Очки отображают в реальном времени скорость, высоту, общее...", "entry_price_old":{ "price_raw":340, "price":"340.00$" }, "entry_unit":"Размер", "entry_id":"5", "entry_solds":"0", "entry_modified_time":"1333614702", "entry_cats":{ "cats":[ { "url":"gadjets/sport", "name":"Спорт", "id":"6" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"320.00", "price":"320.00$" }, "entry_description":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения.\n\nОчки отображают в реальном времени скорость, высоту, общее расстояние, количество ваших спусков, температуру и время. Ваши данные сохраняются во встроенной памяти, после чего вы можете сбросить их на свой компьютер и посмотреть свои достижения на Google Maps. Очки оснащены различными датчиками, которые фиксируют окружающую информацию. Управление осуществляется с помощью трех больших кнопок. Аккумулятор может работать автономно до 8 часов.\n\n", "entry_price_vat_eval":{ "price_raw":500, "price":"500.00$" }, "entry_views":"6", "num_com":"0", "entry_title":"Новые очки от Recon Transcend", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"12мес", "entry_added_time":"1333614645", "entry_art_no":"32165468-6898", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/sport", "pname":"Гаджеты", "name":"Спорт", "id":"6" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":500, "price":"500.00$" }, "entry_ordered":"1", "entry_brand":"Transcend", "entry_others":{ "other3":"ЗУ в комплект не входит", "other2":"Не бьются", "other1":"20x20x20" }, "entry_hgu":"sport-glasses", "entry_shop_url":"http://yoursite.ucoz.ru/shop/5/desc/sport-glasses", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/5s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/5.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/5m.jpg" } } }, "0":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"Материальный товар. В описании содержится видео", "entry_price_old":{ "price_raw":80, "price":"80.00$" }, "entry_unit":"шт.", "entry_id":"4", "entry_solds":"0", "entry_modified_time":"1456269049", "entry_cats":{ "cats":[ { "url":"gadjets/games", "name":"Игры", "id":"5" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"50.00", "price":"50.00$" }, "entry_description":"Геймпад для смартфонов и планшетов iControlpad совместим с любыми устройствами, поддерживающими bluetooth (включая компьютеры и игровые консоли). Универсальный холдер может подсоединиться к любому смартфону.
    Геймпад протестирован на iPhone, iPod Touch, Blackberry Torch, Galaxy 2, Galaxy 2S, HTC Desire HD, Nokia N8, Nexus One и т.д.

    Геймпад для смартфонов и планшетов iControlpad превращает смартфон в портативную игровую приставку. Оснащен двумя аналоговыми джойстиками, цифровыми стрелками. Имеет 8 кнопок, эмулирует игры с 8 платформ.

    Встроенный аккумулятор 1350мА может подзарядить аккумулятор смартфона через USB.

    ", "entry_price_vat_eval":{ "price_raw":60, "price":"60.00$" }, "entry_views":"7", "num_com":"0", "entry_title":"Геймпад для смартфонов и планшетов iControlpad", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"", "entry_added_time":"1333614409", "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":4, "rating_num":"4", "rated":"1", "rating":"4.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/games", "pname":"Гаджеты", "name":"Игры", "id":"5" }, "entry_add_user":"uAPI", "entry_add_uid":"7", "entry_file_size":0, "entry_price":{ "price_raw":60, "price":"60.00$" }, "entry_ordered":"0", "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"gejmpad-dlja-smartfonov-i-planshetov-icontrolpad", "entry_shop_url":"http://yoursite.ucoz.ru/shop/4/desc/gejmpad-dlja-smartfonov-i-planshetov-icontrolpad", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/4s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/4.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/4m.jpg" } } }, "2":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"Перчатки Burton Mix Master – это просто мечта для настоящего любителя сноубординга. Эти перчатки легко гнутся там, где должны гнуться, обладают немалым запасом прочности, отлично дышат, но в то же время активно сберегают тепло. Да, кстати, внутри их на...", "entry_price_old":{ "price_raw":"0.00", "price":0 }, "entry_unit":"шт.", "entry_id":"6", "entry_solds":"0", "entry_modified_time":"1333614812", "entry_cats":{ "cats":[ { "url":"gadjets/sport", "name":"Спорт", "id":"6" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"0.00", "price":0 }, "entry_description":"Перчатки Burton Mix Master – это просто мечта для настоящего любителя сноубординга. Эти перчатки легко гнутся там, где должны гнуться, обладают немалым запасом прочности, отлично дышат, но в то же время активно сберегают тепло. Да, кстати, внутри их находится и легендарная мембрана Dryride, благодаря которой руки практически не потеют.", "entry_price_vat_eval":{ "price_raw":160, "price":"160.00$" }, "entry_views":"4", "num_com":"0", "entry_title":"Перчатки Burton Mix Master", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"", "entry_added_time":"1333614765", "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/sport", "pname":"Гаджеты", "name":"Спорт", "id":"6" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":160, "price":"160.00$" }, "entry_ordered":"0", "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"perchatki-burton-mix-master", "entry_shop_url":"http://yoursite.ucoz.ru/shop/6/desc/perchatki-burton-mix-master", "entry_type":"0", "entry_photo":{ "num_photos":16, "others_photo":{ "6":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_6.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_6.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_6.jpg" }, "11":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_11.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_11.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_11.jpg" }, "3":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_3.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_3.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_3.jpg" }, "7":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_7.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_7.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_7.jpg" }, "9":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_9.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_9.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_9.jpg" }, "12":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_12.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_12.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_12.jpg" }, "2":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_2.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_2.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_2.jpg" }, "15":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_15.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_15.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_15.jpg" }, "14":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_14.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_14.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_14.jpg" }, "8":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_8.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_8.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_8.jpg" }, "1":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_1.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_1.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_1.jpg" }, "4":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_4.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_4.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_4.jpg" }, "13":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_13.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_13.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_13.jpg" }, "10":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_10.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_10.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_10.jpg" }, "5":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s_5.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6_5.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m_5.jpg" } }, "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m.jpg" } } } }, "meta_data":{ "META_DESCRIPTION":"Гаджеты Спорт Игры. Необычные товары. Категория содержит подкатегории", "META_TITLE":"Гаджеты" }, "cat_url":"gadjets" } }
     

    [POST] Добавить/исключить товар из "Мой список желаний"


    С помощью запроса можно добавить какой-либо товар в личный список желаний. Для этого используется параметр goods_id=ID
    Для очистки желаний (удалить все товары из списка) – используйте параметр clear=1

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { CATEGORY_DATA GOODS_LIST } }
    POSTSHOP /uapi/shop/wishlisth?goods_id=ID //для добавления. Для удаления ?clear=1
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/wishlisth', array( 'goods_id' => 'ID' //или 'clear' => '1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Товар добавлен в список желаний", "sort":{ "sort":"added_time", "order":"desc", "slist":[ { "name":"Наименование", "field":"name" }, { "name":"Цена", "field":"price" }, { "name":"Дата добавления", "field":"added_time" } ] }, "duplicate":0, "meta_data":{ "META_DESCRIPTION":"Товары Dmitry_DM. Новые очки от Recon Transcend, newname", "META_TITLE":"" }, "goods_list":{ "1":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"", "entry_price_old":{ "price_raw":"0.00", "price":0 }, "entry_unit":"шт.", "entry_id":"1", "entry_solds":"456", "entry_modified_time":"1458510093", "entry_cats":{ "cats":[ { "url":"digital-goods", "name":"Цифровые товары", "id":"1" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"0.00", "price":0 }, "entry_description":"", "entry_price_vat_eval":{ "price_raw":0, "price":0 }, "entry_views":"123", "num_com":"1", "entry_title":"newname", "entry_is_in_basket":0, "entry_is_hidden":"1", "entry_warr":"", "entry_added_time":"1333613619", "entry_art_no":"", "entry_is_in_wishlist":1, "entry_options":{ }, "entry_rating":{ "rating_num_float":10, "rating_num":"10", "rated":"10", "rating":"9.8" }, "entry_cat":{ "pid":"0", "purl":null, "url":"digital-goods", "pname":"", "name":"Цифровые товары", "id":"1" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":"0.00", "price":0 }, "entry_ordered":"789", "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"newname", "entry_shop_url":"http://yoursite.ucoz.ru/shop/1/desc/newname", "entry_type":"0", "entry_photo":{ "num_photos":0, "others_photo":"", "def_photo":{ "small":"http://s4.ucoz.net/img/sh/nfs.png", "photo":"http://s4.ucoz.net/img/sh/nf.png", "thumb":"http://s4.ucoz.net/img/sh/nf.png" } } }, "0":{ "entry_is_in_discount":1, "entry_weight":{ "weight":"300.00", "weight_raw":"300.0000" }, "entry_stock":{ "stock_total":"10", "stock":"10" }, "entry_brief":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения. Очки отображают в реальном времени скорость, высоту, общее...", "entry_price_old":{ "price_raw":340, "price":"340.00$" }, "entry_unit":"Размер", "entry_id":"5", "entry_solds":"0", "entry_modified_time":"1333614702", "entry_cats":{ "cats":[ { "url":"gadjets/sport", "name":"Спорт", "id":"6" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"320.00", "price":"320.00$" }, "entry_description":"Кататься по заснеженным склонам в таких очках будет действительно здорово, благодаря встроенному GPS навигатору, датчику скорости, и возможности определить координаты вашего местонахождения.\n\nОчки отображают в реальном времени скорость, высоту, общее расстояние, количество ваших спусков, температуру и время. Ваши данные сохраняются во встроенной памяти, после чего вы можете сбросить их на свой компьютер и посмотреть свои достижения на Google Maps. Очки оснащены различными датчиками, которые фиксируют окружающую информацию. Управление осуществляется с помощью трех больших кнопок. Аккумулятор может работать автономно до 8 часов.\n\n", "entry_price_vat_eval":{ "price_raw":500, "price":"500.00$" }, "entry_views":"6", "num_com":"0", "entry_title":"Новые очки от Recon Transcend", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"12мес", "entry_added_time":"1333614645", "entry_art_no":"32165468-6898", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/sport", "pname":"Гаджеты", "name":"Спорт", "id":"6" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":500, "price":"500.00$" }, "entry_ordered":"1", "entry_brand":"Transcend", "entry_others":{ "other3":"ЗУ в комплект не входит", "other2":"Не бьются", "other1":"20x20x20" }, "entry_hgu":"sport-glasses", "entry_shop_url":"http://yoursite.ucoz.ru/shop/5/desc/sport-glasses", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/5s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/5.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/5m.jpg" } } } }, "filters":{ "fdata":{ "brand":{ "Transcend":{ "pos":1, "cnt":"1" } } }, "filters":{ "for_uri":"" } }, "goods_count":"2", "paginator":{ "cur_page":1, "num_pages":1 } } }
     

    [GET] Получить товары пользователя


    Запрос имитирует веб-страницу, которая доступна по адресу /shop/user/[ID]/goods

    Дополнительные параметры запроса

    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Возможные значения:
      • id – по ID
      • art – по артикулу
      • brand – по производителю
      • name – по названию (значение по умолчанию)
      • price – по цене
      • warr – по гарантии
      • weight – по весу
      • added_time – по дате добавления товара
      • modified_time – по дате изменения товара
      • num_com – по количеству комментариев
      • rating – по рейтингу
      • ordered – по количеству оформлений в заказах
      • views – по количеству просмотров
      • solds – по количеству продаж
      • other# – по дополнительному полю 1-9
    • order=SORT_MODE – [Строка] – режим сортировки
      • Возможные значения:
      • asc – по возрастанию (значение по умолчанию)
      • desc – по убыванию
    • f_art=BASE64_ARTICULE – [Строка] – Фильтр по артикулу (значение должно быть в Base64) *
    • f_brand=BASE64_BRAND – [Строка] – Фильтр по производителю (значение должно быть в Base64) *
    • f_name=BASE64_NAME – [Строка] – Фильтр по названию (значение должно быть в Base64) *
    • f_warr=BASE64_WARR – [Строка] – Фильтр по гарантии (значение должно быть в Base64) *
    • f_weight=BASE64_WEIGHT – [Строка] – Фильтр по весу (значение должно быть в Base64) *
    • f_stock=NUMBER – [Число] – Фильтр по остатку (значение должно быть в Base64) *
    • f_status=BASE64_STATUS – [Строка] – Фильтр по статусу (значение должно быть в Base64) *
    • f_price=BASE64_PRICE – [Строка] – Фильтр по по цене (значение должно быть в Base64. В качестве базовой строки для формирования Base64-значения должна браться строка формата '<МИН_ЦЕНА>|<МАКС_ЦЕНА>|<КОД_ВАЛЮТЫ>') *
    • f_other#=BASE64_OTHER – [Строка] – фильтр по дополнительному полю 1-9 (значение должно быть в Base64) *
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    • pnum=PAGE_NUM – [Число] – Номер текущей страницы (значение по умолчанию - 1)
    * Учитываются только те фильтры, которые разрешены в настройках магазина

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    Расшифровка ответа

    • CATEGORY_DATA – Cекция с данными категории
      • Содержит поля:
      • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
      • filters - FILTERS_DATA – секция с данными по фильтрам товаров категории
      • paginator – секция с данными по пагинатору выборки. cur_page - номер текущей страницы выборки, заданный параметром pnum. num_pages - количество страниц выборки.
      • duplicate – признак, что запрос был отправлен на дублирующуюся по URL страницу (например, /category;0 /category;1)
      • goods_count – количество товаров в категории
      • meta_data – META-DATA - секция с META-данными категории
    • sort - SORT_DATA – Cекция с данными по режимах сортировки товаров категории
      • Содержит поля:
      • sort – поле по которому был отсортирован список товаров
      • order – использованный режим сортировки
      • slist – секция с подписями к полям сортировки. field - поле сортировки. name - подпись к полю
    • FILTERS_DATA – секция с данными по фильтрам товаров категории
      • Содержит поля:
      • fdata – набор данных по фильтрам (все возможные значения фильтра, мин/макс значение для фильтра по цене, позиция каждого значения фильтра в блоке значений и количество товаров подпадающих под каждое значение фильтра).
      • filters – значения примененых фильтров. for_uri - содержит строку с фильтрами, если включена опция “Дублировать фильтры товаров в адресной строке
    • META-DATA – секция с META-данными категории
      • Содержит поля:
      • meta_title – содержимое TITLE-тега
      • meta_description – содержимое тега <meta name="description" content="..." />
    • GOODS_LIST – секция со списком товаров категории. Данная секция содержит список подсекций с данными по каждому выбранному товару. ID подсекции - порядковый номер подсекции в списке подсекций
      • Содержит поля:
      • entry_id – ID товара
      • entry_title – наименование товара
      • entry_cat – ENTRY_CAT - секция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
      • entry_cats – ENTRY_CATS - секция с дополнительными категориями товара
      • entry_brand – значение поля “Производитель”
      • entry_brief – краткое описание товара
      • entry_description – описание товара
      • entry_photo – ENTRY_PHOTO - секция с изображениями товара
      • entry_hgu – ЧПУ товара
      • entry_shop_url – URL товара в магазине
      • entry_type – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
      • entry_price – цена товара
      • entry_price_in – входящая цена товара
      • entry_price_old – старая цена товара
      • entry_price_vat – цена товара с НДС (если в настройках магазина включен расчет НДС)
      • entry_price_vat_eval – цена товара без НДС (если в настройках магазина включен расчет НДС)
      • entry_unit – значение поля “Единица”
      • entry_weight – вес товара
      • entry_art_no – значение поля “Артикул”
      • entry_stock – остаток товара
      • entry_warr – значение поля “Гарантия”
      • entry_others – секция со значениями дополнительных полей товара. Количество элеметов секции зависит от количества дополнительных полей товара, установленного в настройках магазина.
      • entry_options – ENTRY_OPTIONS - секция с опциями товара
      • entry_is_in_discount – признак, что товар включается в расчет скидок
      • entry_is_hidden – признак, что товар скрыт
      • entry_is_in_basket – признак, что товар добавлен в корзину текущего пользователя
      • entry_is_in_wishlist – признак, что товар добавлен в список желаний текущего пользователя
      • entry_rating – ENTRY_RATING - секция с данными по рейтингу товара
      • entry_views – количество просмотров товара
      • entry_solds – количество продаж товара
      • entry_ordered – количество заказов, оформленных с данным товаром
      • num_com – оличество комментариев товара
      • entry_file_size – размер прикрепленного к товару файла
      • entry_add_uid – ID пользователя, добавившего товар
      • entry_add_user – логин пользователя, добавившего товар
      • entry_added_time – время добавления товара
      • entry_modified_time – время последнего изменения товара
    • ENTRY_CAT – екция с данными категории товара (может отличаться от данных категории в секции CATEGORY_DATA, если товар находится в дочерней категории)
    • sort=FIELD_NAME – [Строка] – поле по которому будет отсортирован список товаров
      • Содержит поля:
      • id – ID товара
      • pid – ID родительской категории
      • name – название категории товара
      • pname – название родительской категории товара
      • url – URI категории относительно корня магазина
      • purl – URI родительской категории относительно корня магазина
    • ENTRY_CATS – секция с дополнительными категориями товара
      • Содержит поля:
      • cats – подсекция с данными дополнительных категорий товара. id - ID категории. url - URI категории относительно корня магазина. name - название категории.
      • num_cats – количество дополнительных категорий товара
    • ENTRY_PHOTO – секция с изображениями товара
      • Содержит поля:
      • num_photos – количество изображений
      • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
      • others_photo – секциями с данными других изображений товара (набор полей аналогичен секции def_photo)
  • sort - SORT_DATA – секция с данными по режимах сортировки товаров категории
  • GETSHOP /uapi/shop/request?page=usergoods&user_id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/request', array( 'page' => 'usergoods', 'user_id' => '[ID]' )); print_r($response); //Получаем ответ ?>
    { "success":{ "sort":{ "sort":"added_time", "order":"desc", "slist":[ { "name":"Наименование", "field":"name" }, { "name":"Цена", "field":"price" }, { "name":"Дата добавления", "field":"added_time" } ] }, "duplicate":0, "meta_data":{ "META_DESCRIPTION":"Товары uAPI. Геймпад для смартфонов и планшетов iControlpad", "META_TITLE":"" }, "goods_list":{ "0":{ "entry_is_in_discount":1, "entry_weight":{ "weight":0, "weight_raw":"0.0000" }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"Материальный товар. В описании содержится видео", "entry_price_old":{ "price_raw":80, "price":"80.00$" }, "entry_unit":"шт.", "entry_id":"4", "entry_solds":"0", "entry_modified_time":"1456269049", "entry_cats":{ "cats":[ { "url":"gadjets/games", "name":"Игры", "id":"5" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"50.00", "price":"50.00$" }, "entry_description":"Геймпад для смартфонов и планшетов iControlpad совместим с любыми устройствами, поддерживающими bluetooth (включая компьютеры и игровые консоли). Универсальный холдер может подсоединиться к любому смартфону.
    Геймпад протестирован на iPhone, iPod Touch, Blackberry Torch, Galaxy 2, Galaxy 2S, HTC Desire HD, Nokia N8, Nexus One и т.д.

    Геймпад для смартфонов и планшетов iControlpad превращает смартфон в портативную игровую приставку. Оснащен двумя аналоговыми джойстиками, цифровыми стрелками. Имеет 8 кнопок, эмулирует игры с 8 платформ.

    Встроенный аккумулятор 1350мА может подзарядить аккумулятор смартфона через USB.

    ", "entry_price_vat_eval":{ "price_raw":60, "price":"60.00$" }, "entry_views":"5", "num_com":"0", "entry_title":"Геймпад для смартфонов и планшетов iControlpad", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_warr":"", "entry_added_time":"1333614409", "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":4, "rating_num":"4", "rated":"1", "rating":"4.0" }, "entry_cat":{ "pid":"2", "purl":"gadjets", "url":"gadjets/games", "pname":"Гаджеты", "name":"Игры", "id":"5" }, "entry_add_user":"uAPI", "entry_add_uid":"7", "entry_file_size":0, "entry_price":{ "price_raw":60, "price":"60.00$" }, "entry_ordered":"0", "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"gejmpad-dlja-smartfonov-i-planshetov-icontrolpad", "entry_shop_url":"http://yoursite.ucoz.ru/shop/4/desc/gejmpad-dlja-smartfonov-i-planshetov-icontrolpad", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/4s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/4.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/4m.jpg" } } } }, "filters":"", "goods_count":"1", "paginator":{ "cur_page":1, "num_pages":1 } } }
     

    [GET] Получить параметры товара


    С помощью запроса можно добавить какой-либо товар в личный список желаний. Для этого используется параметр goods_id=ID
    Для очистки желаний (удалить все товары из списка) – используйте параметр clear=1

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { GOODS_DATA } }
    GETSHOP /uapi/shop/request?page=viewgoods&id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/request', array( 'page' => 'viewgoods', 'id' => '[ID]', )); print_r($response); //Получаем ответ ?>
    { "success":{ "entry_is_in_discount":1, "recommended_products":{ "present":0, "recomm_products":{ } }, "entry_weight":{ "weight":"", "weight_raw":0 }, "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_brief":"Перчатки Burton Mix Master – это просто мечта для настоящего любителя сноубординга. Эти перчатки легко гнутся там, где должны гнуться, обладают немалым запасом прочности, отлично дышат, но в то же время активно сберегают тепло. Да, кстати, внутри их на...", "entry_price_old":{ "price_raw":0, "price":0 }, "entry_unit":"шт.", "entry_id":"6", "entry_solds":"0", "entry_modified_time":"1333614812", "entry_cats":{ "cats":[ { "url":"gadjets/sport", "name":"Спорт", "id":"6" } ], "num_cats":1 }, "entry_price_vat":{ "price_raw":0, "price":0 }, "entry_price_in":{ "price_raw":"0.00", "price":"0.00$" }, "entry_description":"Перчатки Burton Mix Master – это просто мечта для настоящего любителя сноубординга. Эти перчатки легко гнутся там, где должны гнуться, обладают немалым запасом прочности, отлично дышат, но в то же время активно сберегают тепло. Да, кстати, внутри их находится и легендарная мембрана Dryride, благодаря которой руки практически не потеют.", "entry_price_vat_eval":{ "price_raw":160, "price":"160.00$" }, "entry_spec":"", "entry_views":"3", "entry_title":"Перчатки Burton Mix Master", "entry_is_in_basket":0, "entry_is_hidden":"0", "entry_meta_data":{ "meta_description":"Перчатки Burton Mix Master Гаджеты Спорт", "meta_title":"" }, "entry_warr":"", "entry_added_time":"1333614765", "entry_art_no":"", "entry_is_in_wishlist":0, "entry_options":{ }, "entry_rating":{ "rating_num_float":0, "rating_num":"0", "rated":"0", "rating":"0.0" }, "entry_cat":{ "name":"Спорт", "url":"gadjets/sport", "id":"6", "shop_url":"http://yoursite.ucoz.ru/shop/gadjets/sport" }, "entry_add_user":"Tom", "entry_add_uid":"1", "entry_file_size":0, "entry_price":{ "price_raw":160, "price":"160.00$" }, "entry_ordered":"0", "entry_brand":"", "entry_others":{ "other3":"", "other2":"", "other1":"" }, "entry_hgu":"perchatki-burton-mix-master", "entry_shop_url":"http://yoursite.ucoz.ru/shop/6/desc/perchatki-burton-mix-master", "entry_type":"0", "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/6s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/6.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/6m.jpg" } } } }
     

    [GET] Получить опции товара


    Получение опций товара. Добавление опций доступно в ПУ сайта, опции для товара конкретного – при редактировании/добавления материала в веб-версии

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { 'options': OPTIONS_LIST } }

    Расшифровка ответа

    OPTIONS_LIST – секция со списком опций товара. Данная секция содержит список подсекций с данными по каждой опции товара. ID подсекции - порядковый номер опции в списке опций. Каждая подсекция содержит следующие поля:

    • name – название опции
    • selected – признак, что опция включена для указанного товара
    • pos – позиция опции в списке опций
    • values – список значений опции в формате “ПОРЯДКОВЫЙ_НОМЕР:НАЦЕНКА”
    • use_images – значение признака “Использовать изображения”
    • as_checkbox – значение признака “В виде checkbox”
    • as_radio – значение признака “Выводить в виде "radio buttons"”
    • check_first – значение признака “Выделять первое значение в "radio buttons"”
    GETSHOP /uapi/shop/editgoods?method=opt-load&id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/editgoods', array( 'method' => 'opt-load', 'id' => '1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "options":{ "1":{ "name":"Размер", "values":{ "1":"0.00", "3":"0.00", "0":"0.00", "2":"0.00" }, "use_images":"0", "as_checkbox":0, "as_radio":"0", "pos":1, "check_first":"0", "selected":0 } } } }
     

    [GET] Наценка по опции товара


    Для каждой опции можно сделать наценку: например, при выборе цвета Красный – к цене добавлять 10$. Этот запрос покажет какие наценки применяются к товару

    Дополнительные параметры запроса

    • opt=OPTIONS – [Строка] – строка с выбранными опциями в формате “-:-:...,” где OPTION_ID - ID опции, ID_SELECTED_VALUE - ID выбранного значения
    • opt_id=OPTION_ID – [Число] – ID выбранной опции
    • cnt=CNT – [Число] – количество товаров

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { GOODS_DATA } }

    Расшифровка ответа

    GOODS_DATA - секция с данными товара. Содержит следующие поля:

    • goods_id – ID товара
    • art – артикул товара
    • selected_cnt – количество товаров, указанное во входном параметре cnt
    • stock – остаток товара
    • price – цена товара с учетом наценки и указанного количества
    • oldprice – старая цена товара с учетом наценки и указанного количества
    • img_num – порядковый номер изображения товара, привязанного к указанной опции (номерация с нуля)
    • small – URL к изображению-иконке товара
    • thumb – URL к изображению-превю товара
    • photo – URL к полному изображению товара
    GETSHOP /uapi/shop/request?page=viewgoods&id=[ID]&mode=opt-sel
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/request', array( 'page'=>'viewgoods', 'id'=>'1', 'mode'=>'opt-sel' )); print_r($response); //Получаем ответ ?>
    { "success":{ "goods_id":"1", "art":"", "selected_cnt":"1", "oldprice":{ "over":0, "price_raw":0, "price":"0.00$" }, "price":{ "over":0, "price_raw":0, "price":"0.00$" }, "stock":"0" } }
     

    [GET] Отзывы товара


    У каждого товара существует своя уникальная опция: отзывы (комментарии). С этим запросом мы можем получить список всех отзывов к товару

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { DATA }

    Расшифровка ответа

    DATA - секция с комментариями товара. Содержит следующие поля

    • id – ID товара, по которому были запрошены комментарии
    • page – количество страниц комментариев
    • pages_list – возможные страницы в переключателе комментариев
    • per_page – количество комментариев на странице
    • total_msg – общее количество комментариев

    MESSAGES_LIST - секция с комментариями товара. Каждая подсекция содержит следующие поля

  • id – ID комментария
  • parent_id – ID родительского комментария
  • www – значение поля "WWW"
  • answer – ответ для комментария
  • avatar – ссылка на аватар пользователя, оставившего комментарий
  • author – никнейм пользователя, оставившего комментарий
  • pending – признак ожидания модерации комментарий (yes/no)
  • full_name – полное имя, добавившего комментарий
  • message – текст комментария
  • rate – текущий рейтинг комментария
  • add_date – дата добавления комментария
  • email – значение поля "Email"
  • GETSHOP /uapi/shop/comments?id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/comments', array( 'id'=>'1' )); print_r($response); //Получаем ответ ?>
    { "messages":[ { "www":"", "answer":"", "original_answer":"", "avatar":"http://2093175133.uid.me/avatar.jpg", "author":"Dmitry_DM", "pending":"no", "full_name":"Dmitry K.", "message":"Оценить текущее состояние тяжело!", "rate":0, "add_date":"2016-03-20 23:06", "email":"", "rateuids":"", "id":18, "original_message":"Оценить текущее состояние тяжело!" } ], "id":1, "total_msg":1 }
     

    [POST] Добавить товар


    Полноценное добавление товара в магазин

    Дополнительные параметры запроса

    • cats_add=ADDITIONAL_CATEGORIES – [Строка] – список ID дополнительных категорий в формате "[ID1, ID2, ID3,...]"
    • ch_addcat=1 – [Число] – указывает на наличие дополнительных категорий. Обязателен, если присутствует параметр cats_add, иначе параметр cats_add не будет учтен
    • brand=GOODS_BRAND – [Строка] – значение поля “Производитель”
    • brief=GOODS_BRIEF_DESCRIPTION – [Строка] – краткое описание товара
    • undisc=[0|1] – [Число] – значение поля “Исключить товар из скидок”
    • dscr=GOODS_DESCRIPTION – [Строка] – описание товара
    • user=GOODS_USER – [Строка] – значение поля “Субагент”
    • tags=GOODS_TAGS – [Строка] – список тегов товара (через запятую)
    • url=GOODS_HGU – [Строка] – значение поля “Человеко Понятный Урл”
    • meta_title=GOODS_META_TITLE – [Строка] – значение поля “HTML Заголовок страницы”
    • meta_dscr=GOODS_META_DESCRIPTION – [Строка] – значение поля “HTML meta description”
    • type=GOODS_TYPE – [Число] – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
    • file_mode=MODE – [Строка] – тип источника файла (“data” - загрузка с сервера из которого отправляются API-запросы, “move” - выбор файла на сервере магазина). Обязателен при type=1
    • file_data=FILE_PATH – [Строка] – путь к файлу на сервере из которого отправляются API-запросы. Обязателен при file_mode=data
    • file_move=FILE_PATH – [Строка] – путь к файлу на сервере магазина. Обязателен при file_mode=move
    • data=CODES_LIST – [Строка] – Список электронных кодов. Обязателен при type=2
    • price=GOODS_PRICE – [Число] – цена товара
    • price_in=GOODS_PRICE – [Число] – входящая цена товара
    • price_old=GOODS_PRICE – [Число] – старая цена товара
    • unit=GOODS_UNIT – [Строка] – значение поля “Единица”
    • weight=GOODS_WEIGHT – [Число] – значение поля “Вес”
    • art=GOODS_ART – [Строка] – значение поля “Артикул”
    • stock=GOODS_STOCK – [Строка] – значение поля “Наличие (или дата ожидания товара)”
    • warr=GOODS_WARR – [Строка] – значение поля “Гарантия”
    • otherN=GOODS_OTHER – [Строка] – значение поля “Дополнительное поле N”. Количество дополнительных полей завист от настроек магазина, но не может быть больше девяти
    • opt_N_over_M=GOODS_OPTION – [Строка] – значение опции товара, где N - порядковый номер опции товара, M - порядковый номер значения опции товара
    • recommended-products-set-0-recommended-products=GOODS_LIST – [Строка] – список ID товаров для поля “С этим товаром покупают” (через запятую)
    • hide=[0|1] – [Число] – значение поля “Скрыть”

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { GOODS_DATA } }

    Расшифровка ответа

    GOODS_DATA - секция с данными товара. Содержит следующие поля:

    • goods_id – ID товара
    • art – артикул товара
    • selected_cnt – количество товаров, указанное во входном параметре cnt
    • stock – остаток товара
    • price – цена товара с учетом наценки и указанного количества
    • oldprice – старая цена товара с учетом наценки и указанного количества
    • img_num – порядковый номер изображения товара, привязанного к указанной опции (номерация с нуля)
    • small – URL к изображению-иконке товара
    • thumb – URL к изображению-превю товара
    • photo – URL к полному изображению товара
    POSTSHOP /uapi/shop/addgoods?method=submit&cat_id=[CATEGORY_ID]&name=[GOODS_NAME]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/addgoods', array( 'method'=>'submit', 'cat_id'=>'1', 'name'=>'GOODS_NAME' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Материал успешно добавлен", "goods_data":{ "entry_cat":{ "name":"Цифровые товары", "url":"digital-goods", "id":"1", "shop_url":"http://yoursite.ucoz.ru/shop/digital-goods" }, "entry_hgu":"goods_name", "entry_shop_url":"http://yoursite.ucoz.ru/shop/51/desc/goods_name", "entry_cats":{ "cats":[ { "url":"digital-goods", "name":"Цифровые товары", "id":"1" } ], "num_cats":1 }, "entry_id":"51" } } }
     

    [POST] Редактор товара


    Полноценное редактирование товара в магазине

    Дополнительные параметры запроса

    • cats_add=ADDITIONAL_CATEGORIES – [Строка] – список ID дополнительных категорий в формате "[ID1, ID2, ID3,...]"
    • ch_addcat=1 – [Число] – указывает на наличие дополнительных категорий. Обязателен, если присутствует параметр cats_add, иначе параметр cats_add не будет учтен
    • brand=GOODS_BRAND – [Строка] – значение поля “Производитель”
    • brief=GOODS_BRIEF_DESCRIPTION – [Строка] – краткое описание товара
    • undisc=[0|1] – [Число] – значение поля “Исключить товар из скидок”
    • dscr=GOODS_DESCRIPTION – [Строка] – описание товара
    • user=GOODS_USER – [Строка] – значение поля “Субагент”
    • tags=GOODS_TAGS – [Строка] – список тегов товара (через запятую)
    • url=GOODS_HGU – [Строка] – значение поля “Человеко Понятный Урл”
    • meta_title=GOODS_META_TITLE – [Строка] – значение поля “HTML Заголовок страницы”
    • meta_dscr=GOODS_META_DESCRIPTION – [Строка] – значение поля “HTML meta description”
    • type=GOODS_TYPE – [Число] – тип товара (0 - материальный товар, 1 - товар-файл, 2 - товар-электронный код, 3 - товар-услуга)
    • file_mode=MODE – [Строка] – тип источника файла (“data” - загрузка с сервера из которого отправляются API-запросы, “move” - выбор файла на сервере магазина). Обязателен при type=1
    • file_data=FILE_PATH – [Строка] – путь к файлу на сервере из которого отправляются API-запросы. Обязателен при file_mode=data
    • data=CODES_LIST – [Строка] – Список электронных кодов. Обязателен при type=2
    • price=GOODS_PRICE – [Число] – цена товара
    • price_in=GOODS_PRICE – [Число] – входящая цена товара
    • price_old=GOODS_PRICE – [Число] – старая цена товара
    • unit=GOODS_UNIT – [Строка] – значение поля “Единица”
    • weight=GOODS_WEIGHT – [Число] – значение поля “Вес”
    • art=GOODS_ART – [Строка] – значение поля “Артикул”
    • stock=GOODS_STOCK – [Строка] – значение поля “Наличие (или дата ожидания товара)”
    • warr=GOODS_WARR – [Строка] – значение поля “Гарантия”
    • otherN=GOODS_OTHER – [Строка] – значение поля “Дополнительное поле N”. Количество дополнительных полей завист от настроек магазина, но не может быть больше девяти
    • opt_N_over_M=GOODS_OPTION – [Строка] – значение опции товара, где N - порядковый номер опции товара, M - порядковый номер значения опции товара
    • recommended-products-set-0-recommended-products=GOODS_LIST – [Строка] – список ID товаров для поля “С этим товаром покупают” (через запятую)
    • hide=[0|1] – [Число] – значение поля “Скрыть”

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { GOODS_DATA } }

    Расшифровка ответа

    GOODS_DATA - секция с данными товара. Содержит следующие поля:

    • goods_id – ID товара
    • art – артикул товара
    • selected_cnt – количество товаров, указанное во входном параметре cnt
    • stock – остаток товара
    • price – цена товара с учетом наценки и указанного количества
    • oldprice – старая цена товара с учетом наценки и указанного количества
    • img_num – порядковый номер изображения товара, привязанного к указанной опции (номерация с нуля)
    • small – URL к изображению-иконке товара
    • thumb – URL к изображению-превю товара
    • photo – URL к полному изображению товара
    POSTSHOP /uapi/shop/editgoods?method=submit&cat_id=[CATEGORY_ID]&name=[GOODS_NAME]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'cat_id'=>'2', 'id'=>'1', 'name'=>'GOODS_NAME', 'method'=>'submit' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Материал успешно изменен", "goods_data":{ "entry_cat":{ "name":"Гаджеты", "url":"gadjets", "id":"2", "shop_url":"http://yoursite.ucoz.ru/shop/gadjets" }, "entry_hgu":"goods_name", "entry_shop_url":"http://yoursite.ucoz.ru/shop/1/desc/goods_name", "entry_cats":{ "cats":[ { "url":"gadjets", "name":"Гаджеты", "id":"2" } ], "num_cats":1 }, "entry_id":"1" } } }
     

    [GET] Статистика товара


    Вся статистика товара – Получение рейтинга, количества просмотров, продаж, оформлений в заказ и остатка по товару

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { 'goods_data': GOODS_DATA } }

    Расшифровка ответа

    GOODS_DATA - секция с данными товара. Содержит следующие поля

    • entry_id – ID товара
    • entry_views – количество просмотров товара
    • entry_solds – количество продаж товара
    • entry_ordered – количество заказов, оформленных с данным товаром
    • entry_stock – остаток товара
    • entry_rating – ENTRY_RATING - секция с данными по рейтингу товара
    • entry_hgu – ЧПУ товара
    • entry_shop_url – URL товара в магазине
    • rating – рейтинг материала
    • rating_num – количество голосов
    • rating_sum – суммарное количество баллов
    GETSHOP /uapi/shop/editgoods?method=cnt-form&id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/shop/editgoods', array( 'id'=>'1', 'method'=>'cnt-form' )); print_r($response); //Получаем ответ ?>
    { "success":{ "goods_data":{ "entry_ordered":"789", "entry_stock":{ "stock_total":"0", "stock":"" }, "entry_rating":{ "rating_num":"10", "rating_sum":"98", "rating":"9.8" }, "entry_hgu":"goods_name", "entry_shop_url":"http://yoursite.ucoz.ru/shop/1/desc/goods_name", "entry_views":"123", "entry_id":"1", "entry_solds":"456" } } }
     

    [POST] Изменить статистику товара


    Изменение рейтинга, количества просмотров, количества продаж, количества оформлений в заказ и остатка по товару

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { "msg": "Материал успешно изменен" GOODS_DATA } }

    Дополнительные параметры запроса

    • id=GOODS_ID – [Число] – ID товара, по которому нужно получить данные
    • views=VIEWS_CNT – [Число] – количество просмотров товара
    • solds=SOLDS_CNT – [Число] – количество продаж товара
    • ordered=ORDERD_CNT – [Число] – количество оформлений в заказах
    • rate_num=NUM – [Число] – количество голосов рейтинга
    • rate_sum=SUM – [Число] – суммарное количество баллов
    • stock_q=STOCK – [Число] – остаток товара. Учитывается только если включен учёт остатков товара в настройках магазина и для товара не заданы опции.
    POSTSHOP /uapi/shop/editgoods?method=cnt-save&id=GOODS_ID&views=VIEWS_CNT&solds=SOLDS_CNT&ordered=ORDERD_CNT&rate_num=NUM&rate_sum=SUM&stock_q=STOCK
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method'=>'cnt-save', 'id'=>'GOODS_ID', 'views'=>'VIEWS_CNT', 'solds'=>'SOLDS_CNT', 'ordered'=>'ORDERD_CNT', 'rate_num'=>'NUM', 'rate_sum'=>'SUM', 'stock_q'=>'STOCK' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Материал успешно изменен", "goods_data":{ "entry_ordered":"4", "entry_stock":{ "stock_total":"7", "stock":"" }, "entry_rating":{ "rate_sum":"6", "rate_num":"5", "rating":"1.20" }, "entry_hgu":"goods_name", "entry_shop_url":"http://yoursite.ucoz.ru/shop/1/desc/goods_name", "entry_views":"2", "entry_id":"1", "entry_solds":"3" } } }
     

    [POST] Активировать/Скрыть товар


    Товар можно скрыть и он будет доступен только администраторам

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { 'success': { "msg": "Материал успешно изменен" GOODS_DATA } }

    Дополнительные параметры запроса

    • hide=[0|1] – [Число] – значение признака скрытости товара. Если параметр не указан, то признак инвертируется
    POSTSHOP /uapi/shop/editgoods?method=hide&id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method'=>'hide', 'id'=>'GOODS_ID', 'hide'=>'1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Материал успешно изменен", "goods_data":{ "entry_hgu":"goods_name", "entry_shop_url":"http://yoursite.ucoz.ru/shop/1/desc/goods_name", "entry_hide":"1", "entry_id":"1" } } }
     

    [POST] Удалить товар


    Безвозвратное удаление товара

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { "success":{ "msg":"Материал успешно удален" } }
    GETSHOP /uapi/shop/editgoods?method=delete&id=[ID]
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method'=>'delete', 'id'=>'GOODS_ID' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Материал успешно удален" } }
     

    [POST] Добавить изображение товару


    • file_add_N=FILE_PATH – [Строка] – путь к файлу на сервере из которого отсылается API-запрос, где N порядковый номер изображения. Максимально-допустимое количество изображений к товару - 20 шт
    • file_add_cnt=NUM – [Число] – количество загружаемых изображений. Должно соответствовать количеству полей file_add_N

    С помощью запроса можно добавить новое изображение

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { "success":{ "msg":"Изображения добавлены" "goods_data":{ GOODS_DATA } } }

    Дополнительные параметры запроса

    GOODS_DATA - секция с данными товара. Содержит следующие поля

    • entry_id – ID товара, по которому нужно получить данные
    • entry_hgu – ЧПУ товара
    • entry_shop_url – URL товара в магазине
    • entry_photo – секция со списком изображений товара

    ENTRY_PHOTO - секция со списком изображений товара. Данная секция содержит следующие поля:

    • num_photos – количество изображений товара
    • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
    • others_photo – cекциями с данными других изображений товара (набор полей аналогичен секции def_photo)
    POSTSHOP /uapi/shop/editgoods?method=img-add&id=GOODS_ID&file_add_N&FILE_PATH&file_add_cnt=NUM
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method' =>'img-add', 'id' => '49', 'file_add_1' => '@full_XhTGxNnh.jpg', 'file_add_cnt' => '1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Изображения добавлены", "goods_data":{ "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/49s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/49.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/49m.jpg" } }, "entry_hgu":"fsdfsdf", "entry_shop_url":"http://yoursite.ucoz.ru/shop/49/desc/fsdfsdf", "entry_id":"49" } } }
     

    [POST] Изменить изображение товару


    • img=NUM – [Число] – номер изображения в списке изображений товара, которое нужно заменить (номерация файлов начинается с 0-ля)
    • file_N=FILE_PATH – [Строка] – путь к файлу на сервере из которого отсылается API-запрос, где N - номер изображения, указанный в параметра "img"

    С помощью запроса можно отредактировать существующее изображение (заменить)

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { "success":{ "msg":"Изображение изменено" "goods_data":{ GOODS_DATA } } }

    Дополнительные параметры запроса

    GOODS_DATA - секция с данными товара. Содержит следующие поля

    • entry_id – ID товара, по которому нужно получить данные
    • entry_hgu – ЧПУ товара
    • entry_shop_url – URL товара в магазине
    • entry_photo – секция со списком изображений товара

    ENTRY_PHOTO - секция со списком изображений товара. Данная секция содержит следующие поля:

    • num_photos – количество изображений товара
    • def_photo – секция с данными изображения “по умолчанию”. small - URL к изображению-иконке товара. thumb - URL к изображению-превю товара. photo - URL к полному изображению товара
    • others_photo – cекциями с данными других изображений товара (набор полей аналогичен секции def_photo)
    POSTSHOP /uapi/shop/editgoods?method=img-edt&id=GOODS_ID&img=NUM&file_N=FILE_PATH
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method' =>'img-edt', 'id' => '49', 'file_1' => '@full_XhTGxNnh.jpg', 'img' => '1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Изображение изменено", "goods_data":{ "entry_photo":{ "num_photos":1, "others_photo":"", "def_photo":{ "small":"http://yoursite.ucoz.ru/_sh/00/49s.jpg", "photo":"http://yoursite.ucoz.ru/_sh/00/49.jpg", "thumb":"http://yoursite.ucoz.ru/_sh/00/49m.jpg" } }, "entry_hgu":"fsdfsdf", "entry_shop_url":"http://yoursite.ucoz.ru/shop/49/desc/fsdfsdf", "entry_id":"49" } } }
     

    [POST] Удалить изображение товара


    • file_add_N=FILE_PATH – [Строка] – путь к файлу на сервере из которого отсылается API-запрос, где N порядковый номер изображения. Максимально-допустимое количество изображений к товару - 20 шт
    • img=NUM – [Число] – номер изображения в списке изображений товара, которое нужно удалить (нумерация файлов начинается с 0-ля)
    • del_all=1 – флаг, указывающий, что нужно удалить все изображения

    С помощью запроса можно добавить новое изображение

    В случае ошибки

    { 'error' => { ERROR_DATA } }

    В случае успешного ответа

    { "success":{ "msg":"Изображения удалены" "goods_data":{ GOODS_DATA } } }
    POSTSHOP /uapi/shop/editgoods?method=img-del&id=GOODS_ID&img=NUM
    <?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/shop/editgoods', array( 'method' =>'img-del', 'id' => '49', 'img' => '1' )); print_r($response); //Получаем ответ ?>
    { "success":{ "msg":"Изображения удалены", "goods_data":{ "entry_photo":{ "num_photos":0, "others_photo":"", "def_photo":"" }, "entry_hgu":"fsdfsdf", "entry_shop_url":"http://yoursite.ucoz.ru/shop/49/desc/fsdfsdf", "entry_id":"49" } } }
    Яндекс.Метрика