Получение товара вместе с характеристиками по его идентификатору | API Ramis (api.ramis.ru)
Мой кабинет
Барабанный пер., дом 4, стр. 5
Мой кабинет

Получение товара вместе с характеристиками по его идентификатору

Обновление каталога было: 21.07.2024 в 19:54

Описание

Запрос формирует полную информацию о товаре, его название, цены, количество и характеристики по идентификатору товара на сайте, идентификатору в учётной системе (внешнему коду в БД сайта) или артикулу товара. Выборка производится по первому найденному параметру запроса.
 

Формат запроса

[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 не найдены)
 
Мой город
+7 (495) 542-50-98
В рабочие дни 09:00-18:30
г. Москва
Барабанный пер., дом 4, стр. 5

Разработано в АЛЬФА Системс