API Биосвет
1. Общая информация
API предоставляет доступ к информации, размещенной на сайте https://www.biosvet.ru Обмен данными осуществляется по протоколу HTTPS.
Аутентификация происходит при помощи полей Authorization-Login и Authorization-Password, передаваемых в HTTP HEADER.
Важно! Логин и пароль для подключения выдается менеджером компании.
2. Методы API
2.1. Полная выгрузка номенклатуры и остатков
Запрос: GET https://www.biosvet.ru/api/v1/stock/full/
Формат ответа: JSON
| № | Ключ | Тип значения | Описание |
| 1 | create | yyyy-mm-dd hh:mm | дата и время формирования выгрузки |
| 2 | stores | array | массив со списком складов |
| 2.1 | id | int | id склада |
| 2.2 | name | varchar | наименование склада |
| 3 | categories | array | массив со списком категорий товаров |
| 3.1 | id | int | id категории |
| 3.2 | name | varchar | наименование категории |
| 4 | products | array | массив со списком товаров |
| 4.1 | id | int | id товара |
| 4.2 | name | varchar | наименование товара |
| 4.3 | cat_id | int | id категории товара |
| 4.4 | price_rrc | float | рекомендованная розничная цена, руб. |
| 4.5 | price_opt | float | оптовая цена, руб. |
| 4.6 | weight | int | вес товара, граммы |
| 4.7 | unit | varchar | единица измерения товара |
| 4.8 | stock | array | массив со списком остатков по складам |
| 4.8.1 | id | int | id склада |
| 4.8.2 | amount | int | количество на складе |
| 5 | image | varchar | ссылка на фотографию товара |
| 6 | article | varchar | артикул товара |
| 7 | barcode | varchar | штрихкод товара |
| 8 | properties | array | массив со списком характеристик товара |
| 8.1 | name | varchar | название характеристики |
| 8.2 | value | varchar | значение характеристики |
Пример запроса на PHP:
<?php
$url = 'https://www.biosvet.ru/api/v1/stock/full/';
$login = 'XXXXXX';
$password = 'XXXXXXXXX';
$headers = [
'Authorization-Login: ' . $login,
'Authorization-Password: ' . $password
];
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
$response = curl_exec($curl);
curl_close($curl);
$f = fopen("biosvet_full.json","w");
file_put_contents("biosvet_full.json",$response);
fclose($f);
?>
Пример ответа:
[products] => Array
(
[0] => stdClass Object
(
[id] => 28640
[name] => ODEON LIGHT 2056/8C ODL11 242 хром/"венге" Люстра потолочная G9 8*40W 220V STAR
[cat_id] => 59
[price_rrc] => 15065
[price_opt] => 9320
[weight] => 0
[unit] => Штука
[description] =>
[stock] => Array
(
[0] => stdClass Object
(
[id] => 1
[amount] => 0
)
[1] => stdClass Object
(
[id] => 2
[amount] => 0
)
[2] => stdClass Object
(
[id] => 3
[amount] => 0
)
)
[image] => https://www.biosvet.ru/upload/iblock/70a/2056-8C.jpg
[article] => bs000914225
[barcode] => 4690344005579
[properties] => Array
(
[0] => stdClass Object
(
[name] => Высота минимальная, мм
[value] => 170
)
[1] => stdClass Object
(
[name] => Высота встраиваемой части, мм..
[value] => 30
)
[2] => stdClass Object
(
[name] => Потребляемая мощность (W)
[value] => 7
)
[3] => stdClass Object
(
[name] => Диаметр, мм
[value] => 495
)
[4] => stdClass Object
(
[name] => Имя файла
[value] => 2056-8C.jpg
)
[5] => stdClass Object
(
[name] => Высота максимальная, мм
[value] => 170
)
[6] => stdClass Object
(
[name] => Диаметр колбы (мм)
[value] => 45
)
[7] => stdClass Object
(
[name] => Длина лампы (мм)
[value] => 82
)
[8] => stdClass Object
(
[name] => Индекс цветопередачи (Ra), не менее
[value] => 80
)
[9] => stdClass Object
(
[name] => ЯРТ
[value] => 2056/8C
)
[10] => stdClass Object
(
[name] => Серия
[value] => STAR
)
[11] => stdClass Object
(
[name] => Ставки налогов
[value] => 18
)
[12] => stdClass Object
(
[name] => Производитель.
[value] => ODEON (пр-ль)
)
[13] => stdClass Object
(
[name] => Актуальность
[value] => Действующая позиция
)
[14] => stdClass Object
(
[name] => Тип светильника
[value] => люстры потолочные
)
[15] => stdClass Object
(
[name] => Количество ламп
[value] => 8
)
[16] => stdClass Object
(
[name] => Стиль
[value] => Модерн
)
[17] => stdClass Object
(
[name] => Цвет корпуса/арматуры
[value] => Хром
)
[18] => stdClass Object
(
[name] => Патрон
[value] => G9
)
[19] => stdClass Object
(
[name] => Тип светильника.
[value] => Накладной
)
[20] => stdClass Object
(
[name] => Форма.
[value] => Круглая
)
[21] => stdClass Object
(
[name] => Цоколь
[value] => E27
)
[22] => stdClass Object
(
[name] => Тип светильника-
[value] => Настенные
)
[23] => stdClass Object
(
[name] => Встроенная LED-плата-
[value] => Со встренной LED-платой
)
[24] => stdClass Object
(
[name] => Управление светильником-
[value] => Датчик движения
)
[25] => stdClass Object
(
[name] => Комплект.
[value] => Индивидуальное изделие
)
[26] => stdClass Object
(
[name] => Напряжение (V)
[value] => 220V
)
[27] => stdClass Object
(
[name] => Напряжение, V,
[value] => 12V
)
[28] => stdClass Object
(
[name] => Доступ
[value] => Нет
)
[29] => stdClass Object
(
[name] => Тип комплектующих;
[value] => Абажур
)
[30] => stdClass Object
(
[name] => Новинка
[value] => Да
)
)
)
2.2. Краткая выгрузка номенклатуры и остатков
Запрос: GET https://www.biosvet.ru/api/v1/stock/short/
Формат ответа: JSON
| № | Ключ | Тип значения | Описание |
| 1 | create | yyyy-mm-dd hh:mm | дата и время формирования выгрузки |
| 2 | stores | array | массив со списком складов |
| 2.1 | id | int | id склада |
| 2.2 | name | varchar | наименование склада |
| 3 | categories | array | массив со списком категорий товаров |
| 3.1 | id | int | id категории |
| 3.2 | name | varchar | наименование категории |
| 4 | products | array | массив со списком товаров |
| 4.1 | id | int | id товара |
| 4.2 | name | varchar | наименование товара |
| 4.3 | cat_id | int | id категории товара |
| 4.4 | price_rrc | float | рекомендованная розничная цена, руб. |
| 4.5 | price_opt | float | оптовая цена, руб. |
| 4.6 | weight | int | вес товара, граммы |
| 4.7 | unit | varchar | единица измерения товара |
| 4.8 | stock | array | массив со списком остатков по складам |
| 4.8.1 | id | int | id склада |
| 4.8.2 | amount | int | количество на складе |
| 5 | image | varchar | ссылка на фотографию товара |
| 6 | article | varchar | артикул товара |
| 7 | barcode | varchar | штрихкод товара |
Пример запроса на PHP:
<?php
$url = 'https://www.biosvet.ru/api/v1/stock/short/';
$login = 'XXXXXX';
$password = 'XXXXXXXXX';
$headers = [
'Authorization-Login: ' . $login,
'Authorization-Password: ' . $password
];
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
$response = curl_exec($curl);
curl_close($curl);
$f = fopen("biosvet_short.json","w");
file_put_contents("biosvet_short.json",$response);
fclose($f);
?>
Пример ответа:
[products] => Array
(
[0] => stdClass Object
(
[id] => 28640
[name] => ODEON LIGHT 2056/8C ODL11 242 хром/"венге" Люстра потолочная G9 8*40W 220V STAR
[cat_id] => 59
[price_rrc] => 15065
[price_opt] => 9320
[weight] => 0
[unit] => Штука
[stock] => Array
(
[0] => stdClass Object
(
[id] => 1
[amount] => 0
)
[1] => stdClass Object
(
[id] => 2
[amount] => 0
)
[2] => stdClass Object
(
[id] => 3
[amount] => 0
)
)
[image] => https://www.biosvet.ru/upload/iblock/70a/2056-8C.jpg
[article] => bs000914225
[barcode] => 4690344005579
)
