Параметр page=categories имитирует работу переменной $CATEGORIES$ в шаблонизаторе uCoz (вывод всех категорий)
{ 'error' => { ERROR_DATA } }
{
'success':
{
'0': { CATEGORY_DATA }
'1': { CATEGORY_DATA }
...
}
}
parent_id=CATEGORY_ID – [Число] - ID родительской категорииget_globals=[0|1] – [Число] - указывает на то, что нужно получить список глобальных категорий магазина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=categories
<?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' => 'categories'
));
print_r($response); //Получаем ответ
?>
{
"success":[
{
"cat_id":"1",
"cat_descr":"Нематериальные товары",
"goods_count":3,
"cat_img":"",
"cat_name":"Цифровые товары",
"meta_data":{
"META_DESCRIPTION":". Нематериальные товары",
"META_TITLE":"Цифровые товары"
},
"childs":"",
"cat_url":"digital-goods"
},
{
"cat_id":"2",
"cat_descr":"Необычные товары. Категория содержит подкатегории",
"goods_count":4,
"cat_img":"http://yoursite.ucoz.ru/_sh/00/2c.png",
"cat_name":"Гаджеты",
"meta_data":{
"META_DESCRIPTION":"Спорт Игры. Необычные товары. Категория содержит подкатегории",
"META_TITLE":"Гаджеты"
},
"childs":[
{
"cat_id":"5",
"cat_descr":"Игровые товары",
"goods_count":2,
"cat_img":"",
"cat_name":"Игры",
"meta_data":{
"META_DESCRIPTION":". Игровые товары",
"META_TITLE":"Игры"
},
"childs":"",
"cat_url":"gadjets/games"
},
{
"cat_id":"6",
"cat_descr":"",
"goods_count":2,
"cat_img":"",
"cat_name":"Спорт",
"meta_data":{
"META_DESCRIPTION":"",
"META_TITLE":""
},
"childs":"",
"cat_url":"gadjets/sport"
}
],
"cat_url":"gadjets"
},
{
"cat_id":"4",
"cat_descr":"В этой категории содержатся товары с опциями",
"goods_count":2,
"cat_img":"http://yoursite.ucoz.ru/_sh/00/4c.png",
"cat_name":"Одежда",
"meta_data":{
"META_DESCRIPTION":"продажа одежды",
"META_TITLE":"Одежда"
},
"childs":"",
"cat_url":"clothing"
}
]
}
{ 'error' => { ERROR_DATA } }
{
'success':
{
'msg': "Категория успешно добавлена",
'cat_data': CATEGORY_DATA
}
}
pid=PARENT_CAT_ID – [Число] - ID родительской категории. Если указан, то категория будет создана вложенной в указанную родительскую категорию. ID должен быть ID существующей в магазине категории
global_cat=GLOBAL_CAT_ID – [Число] - ID категории группы товаров.dscr=DESCRIPTION – [Строка] - Описание категорииmeta_title=TITLE – [Строка] - HTML Заголовок страницыmeta_dscr=DESCRIPTION – [Строка] - HTML meta descriptionurl=CAT_URI – [Строка] - URI (Человеко Понятный Урл) категорииpos=POS – [Число] - Позиция категории в списке категорийcat_img=IMG_PATH – [Строка] - путь к файлу на сервере из которого отсылается API-запросview_groups=ID_LIST – [Строка] - список, через запятую, ID групп которые будут иметь доступ к категорииadd_groups=ID_LIST – [Строка] - список, через запятую, ID групп которые будут иметь возможность добавлять материалы в категориюexclude_from_discount=[0|1] – [Число] - отключает/включает для категории признак “Исключить из скидок”yml_name=NAME – [Строка] - Название категории для Яндекс.Маркета (yml_fee=FEE – [Строка] - Размер комиссии на товарное предложение ("fee") для Яндекс.Маркетаyml_is_adult=[0|1] – [Число] - отключает/включает атрибут “Категория с товарами adult-секции”yml_is_delivery=[0|1] – [Число] - отключает/включает атрибут “Товары категории доставляются курьерской доставкой”yml_is_pickup=[0|1] – [Число] - отключает/включает атрибут “Самовывоз товаров категории из пунктов выдачи”yml_is_store=[0|1] – [Число] - отключает/включает атрибут “Товары категории можно купить в розничном магазине”yml_name=NAME – [Строка] - Название категории для Яндекс.Маркета (CATEGORY_DATA – Cекция с данными категорииid – ID созданной категорииpid – ID родительской категорииglobal_cat – ID категории группы товаровname – название категорииurl – URI категорииcat_img – полная ссылка на изображение категорииpos – позиция категории в списке категорийview_groups – список, через двоеточие, ID групп которые имеют доступ к категорииadd_groups – список, через двоеточие, ID групп которые имеют возможность добавлять материалы в категориюPOSTSHOP /uapi/shop/edit_cat
<?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/edit_cat', array(
'mode' => 'add',
'name' => 'CAT_NAME'
));
print_r($response); //Получаем ответ
?>
{
"success":{
"msg":"Категория успешно добавлена",
"cat_data":{
"id":"2532",
"view_groups":"",
"url":"cat_name-1",
"cat_img":"http://yoursite.ucoz.ru/.s/img/sh/nfp.png",
"name":"CAT_NAME",
"add_groups":"",
"pos":"20",
"pid":"0",
"global_cat":"0"
}
}
}
{ 'error' => { ERROR_DATA } }
{
'success':
{
'msg': "Категория успешно изменена",
'cat_data': CATEGORY_DATA
}
}
name=NAME – [Строка] - название категорииpid=PARENT_CAT_ID – ID родительской категории. Если указан, то категория будет перемещена в указанную родительскую категорию. ID должен быть ID существующей в магазине категории. Если нужно перенести категорию в корень дерева, то нужно для параметра “pid” указывать значение 0.global_cat=GLOBAL_CAT_ID – [Число] - ID категории группы товаров.dscr=DESCRIPTION – [Строка] - Описание категорииmeta_title=TITLE – [Строка] - HTML Заголовок страницыmeta_dscr=DESCRIPTION – [Строка] - HTML meta descriptionurl=CAT_URI – [Строка] - URI (Человеко Понятный Урл) категорииpos=POS – [Число] - Позиция категории в списке категорийcat_img=IMG_PATH – [Строка] - путь к файлу на сервере из которого отсылается API-запросview_groups=ID_LIST – [Строка] - список, через запятую, ID групп которые будут иметь доступ к категорииadd_groups=ID_LIST – [Строка] - список, через запятую, ID групп которые будут иметь возможность добавлять материалы в категориюexclude_from_discount=[0|1] – [Число] - отключает/включает для категории признак “Исключить из скидок”yml_name=NAME – [Строка] - Название категории для Яндекс.Маркета (yml_fee=FEE – [Строка] - Размер комиссии на товарное предложение ("fee") для Яндекс.Маркетаyml_is_adult=[0|1] – [Число] - отключает/включает атрибут “Категория с товарами adult-секции”yml_is_delivery=[0|1] – [Число] - отключает/включает атрибут “Товары категории доставляются курьерской доставкой”yml_is_pickup=[0|1] – [Число] - отключает/включает атрибут “Самовывоз товаров категории из пунктов выдачи”yml_is_store=[0|1] – [Число] - отключает/включает атрибут “Товары категории можно купить в розничном магазине”yml_name=NAME – [Строка] - Название категории для Яндекс.Маркета (CATEGORY_DATA – Cекция с данными категорииid – ID созданной категорииpid – ID родительской категорииglobal_cat – ID категории группы товаровname – название категорииurl – URI категорииcat_img – полная ссылка на изображение категорииpos – позиция категории в списке категорийview_groups – список, через двоеточие, ID групп которые имеют доступ к категорииadd_groups – список, через двоеточие, ID групп которые имеют возможность добавлять материалы в категориюPOSTSHOP /uapi/shop/edit_cat
<?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/edit_cat', array(
'mode' => 'edit',
'id' => 2532,
'name' => 'Новое название категории'
));
print_r($response); //Получаем ответ
?>
{
"success":{
"msg":"Категория успешно изменена",
"cat_data":{
"id":"2532",
"view_groups":"",
"url":"cat_name-1",
"cat_img":"http://yoursite.ucoz.ru/.s/img/sh/nfp.png",
"name":"Новое название категории",
"add_groups":"",
"pos":"20",
"pid":"0",
"global_cat":"0"
}
}
}
del=1 - [Число] - флаг, указывающий, что нужно удалить изображение. Не учитывается, если указан параметр “cat_img”
{ 'error' => { ERROR_DATA } }
{
'success':
{
'msg': "Изображение изменено",
'cat_data': CATEGORY_DATA
}
}
CATEGORY_DATA – Cекция с данными категорииid – ID созданной категорииpid – ID родительской категорииglobal_cat – ID категории группы товаровname – название категорииurl – URI категорииcat_img – полная ссылка на изображение категорииpos – позиция категории в списке категорийview_groups – список, через двоеточие, ID групп которые имеют доступ к категорииadd_groups – список, через двоеточие, ID групп которые имеют возможность добавлять материалы в категориюPOSTSHOP /uapi/shop/edit_cat
<?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/edit_cat', array(
'mode' => 'img',
'id' => 2532,
'cat_img' => '@1.jpg'
));
print_r($response); //Получаем ответ
?>
{
"success":{
"msg":"Изображение изменено",
"cat_data":{
"id":"2532",
"view_groups":"",
"url":"cat_name-1",
"cat_img":"http://yoursite.ucoz.ru/_sh/25/2532c.jpg",
"name":"Новое название категории",
"add_groups":"",
"pos":"20",
"pid":"0",
"global_cat":"0"
}
}
}
С помощью данного запроса можно отобрахить/скрыть (mode=“show” и mode=”hide” соответственно) категорию с определенным ID
{ 'error' => { ERROR_DATA } }
{
'success':
{
'msg': "Категория успешно изменена",
}
}
POSTSHOP /uapi/shop/edit_cat
<?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/edit_cat', array(
'mode' => 'hide',
'id' => 2532,
));
print_r($response); //Получаем ответ
?>
{
"success":{
"msg":"Категория успешно изменена",
}
}