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