Получение полного списка товаров раздела каталога по его идентификатору
Описание
По имеющимся идентификаторам разделов каталогов можно получить полный список товаров с их данными и характеристиками. В зависимости от передаваемых параметров, есть возможность запрашивать все товары каталога или только товары в наличии.
Формат запроса
[api.ramis.ru/techapi/]?[get=catalog_goods_id]&[token=ваш_токен]&[section_id=1117]&[available=0]
Пример запроса
Параметры запроса
| Параметр | Описание |
|---|---|
| api.ramis.ru/techapi/ | Путь к ресурсу |
| get=catalog_goods_id | Метод получения полного списка товаров каталога по его идентификатору |
| section_id=7 | Идентификатор раздела каталога в БД сайта |
| token=ваш_токен | Токен пользователя |
| available=0 | Параметр получаемых товаров (0 - для получения всех товаров, 1 - для получения только товаров "в наличии") |
Возвращаемые данные
В случае выполнения успешного запроса, возвращается массив с двумя элементами: 'status' со значением 'successful' означающем, что запрашиваемые данные получены и 'result' в котором представлены возвращаемые данные в виде значения или массива 'items' значений, элементы которых представлены в таблице.
| Элемент | Значение |
|---|---|
| id | Идентификатор товара в БД сайта |
| name | Наименование товара |
| amount | Количество товара |
| price_guest | Гостевая (розничная) цена товара |
| price | Цена товара согласно группе пользователя в рублях |
| price_usd | Цена товара согласно группе пользователя в долларах |
| exchange_rate | Текущий курс доллара в БД сайта |
| properties | Массив характеристик товара |
| name | Строковый идентификатор характеристики |
| title | Наименование характеристики |
| type | Тип характеристики |
| value | Значение характеристики |
Возвращаемые ошибки
В случае неудачного выполнения запроса, возвращается массив с двумя элементами: 'status' со значение 'error' означающем, что запрашиваемые данные не получены и 'result' в котором представлены возвращаемые ошибки в виде массива значений, 'code' - код ошибки и 'message' - текстовое значение ошибки, данные которых представлены в таблице.
| Элемент | Значение |
|---|---|
| 100 | section id is not set (не указан илиь не существует ID раздела каталога) |
| 200 | token not found (токен не найден) |
| 300 | unknown error (неизвестная ошибка) |