API-запросы позволяют получить дополнительные сведения о товаре: изображение, данные по конкретной номенклатуре и список позиций из стоп-листа.
Структура запроса
Метод запроса: GET
Адрес запроса зависит от того, что вы хотите получить:
- список позиций, находящихся в стоп-листе — https://api.sbis.ru/retail/nomenclature/stop-list
- изображение товара — https://api.sbis.ru/retail/{img?param=...}, где {img?param=...} — значение параметра images, который получен в результате запроса «Получить список блюд»
- данные по конкретной номенклатуре, в том числе список «С этим товаром покупают» — https://api.sbis.ru/retail/nomenclature/{externalId}, где {externalId} — UUID-идентификатор товара
Параметр | Тип | Описание |
pointId | integer | идентификатор точки продаж |
page | integer | номер страницы |
pageSize | integer | количество записей на странице |
Структура ответа
Параметр | Тип | Описание |
balance | integer | количество товара, доступное для продажи |
count | integer | начальное количество |
externalId | string | UUID-идентификатор товара |
id | integer | идентификатор товара |
images | array[string] | массив ссылок на изображение товара |
name | string | название блюда |
nomNumber | string | код товара, указанный в его карточке |
period | integer | время (в часах), когда товар будет находиться в стоп-листе |
reason | string | причина нахождения в стоп-листе |
stopListId | integer | идентификатор стоп-листа |
outcome | boolean | признак наличия записей на следующих страницах |
Примеры
Получить данные о конкретном товаре, в том числе список «С этим товаром покупают»