Последнее обновление: 11 января 2023 г.
Структура и синтаксис запросов
База данных продукции Systeme Electric, Dekraft, Schneider Electric насчитывает информацию более чем о 200 000 референсов (или “артикулов”). Основная информация структурирована в соответствии со стандартом Etim версий 5, 6 и 7. Дополнительная информация имеет свои собственные классификацию и структуру данных, простые для использования.
Надо отметить, что наиболее полная информация содержится по тарифному периметру. Для них всегда есть информация о цене и остатках. Для всех остальных информации может быть значительно меньше или отсутствовать вообще. Например, чтобы узнать цену или наличие у нетарифных референсов, необходимо запрашивать эту информацию отдельно у вашего менеджера со стороны Systeme Electric. Для таких референсов через API эти данные не передаются.
Информация по референсам (в основном тарифные) обновляется ежедневно и содержит в себе:
Получение данных представляет собой работу с REST API через GET-запросы по протоколу HTTPS. Ответ приходит в виде структурированных сообщений форматов XML или JSON, в кодировке UTF-8.
Пример выдачи в XML:
<content>
<result>success</result>
<data>
<reference>
<commercialRef>GSL000434</commercialRef>
<tariff>
<value>moscow</value>
<description>ШЭ (Москва)</description>
</tariff>
<description>
GLOSSA СВЕТОРЕГУЛЯТОР (диммер) поворотный, 300Вт, в сборе, ТИТАН
</description>
<images>
<image>
<url>
https://static-pcsp.systeme.ru/image/50732/TMcGh147.jpeg
</url>
<is_main>1</is_main>
<size>991557</size>
<type>jpeg</type>
</image>
<image>
<url>
https://static-pcsp.systeme.ru/image/50732/527b8cd7b383dce5b38f7b0c20fc7767101.jpg
</url>
<size>60205</size>
<type>jpg</type>
</image>
Пример выдачи в JSON:
{"result":"success","data":[{"commercialRef":"GSL000434","tariff":"moscow","description":"GLOSSA \u0421\u0412\u0415\u0422\u041e\u0420\u0415\u0413\u0423\u041b\u042f\u0422\u041e\u0420 (\u0434\u0438\u043c\u043c\u0435\u0440) \u043f\u043e\u0432\u043e\u0440\u043e\u0442\u043d\u044b\u0439, 300\u0412\u0442, \u0432 \u0441\u0431\u043e\u0440\u0435, \u0422\u0418\u0422\u0410\u041d","images":[{"url":"https:\/\/static-pcsp.systeme.ru\/image\/50732\/TMcGh147.jpeg","size":991557,"type":"jpeg","is_main":1},{"url":"https:\/\/static-pcsp.systeme.ru\/image\/50732\/527b8cd7b383dce5b38f7b0c20fc7767101.jpg","size":60205,"type":"jpg"},{"url":"https:\/\/static-pcsp.systeme.ru\/image\/50732\/6c9b0ec745ef9ec03216e8ac07b8c345.jpg","size":55208,"type":"jpg"},{"url":"https:\/\/static-pcsp.systeme.ru\/image\/50732\/817b8cd7b383dce5b38f7b0c20fc7767101.jpg","size":35450,"type":"jpg"}
В дальнейшем будут рассматриваться примеры выдачи в формате XML, как более простые для визуального восприятия.
В примерах могут встречаться фигурные скобки {}. В синтаксисе эти скобки не используются, все значения необходимо указывать без них.
Пример ссылки для вызова методов:
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}
/new-api - версия API. Старая версия имеет категорию /api и более не поддерживается. Во избежание ошибок настроена принудительная переадресация всех ссылок на новую версию.
/XML - формат выдачи данных. Поддерживаются форматы XML и JSON.
/getdata - наименование используемого метода для получения данных
/?accessCode={} - параметр, передающий ваш API-Token. Токен должен указываться сразу после знака равно = и не иметь пробелов.
В качестве основного параметра используется API-Token, выдаваемый пользователю при регистрации в системе. Без него доступ к API не будет разрешен системой безопасности.
Каждый метод поддерживает свой собственный список параметров. Этот список обозначается вначале каждого раздела документации.
&page={N} - пагинация, осуществляет переход к указанной странице, где N - ее номер.
Общее количество страниц в выдаче системой не определяется (нецелесообразно), поэтому осуществлять перебор данных постранично нужно до тех пор, пока ответ не перестанет возвращать продуктовые данные (выдача станет пустой).
Пример запроса:
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&page=2
&pageSize={N} – задает количество записей в выдаче, где N - числовое значение. По умолчанию большинство методов содержит лимит в 50 записей на страницу. Максимальное значение лимита 50.
Пример запроса:
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&pageSize=50
&commercialRef={N} – запрос данных по конкретному референсу или списку референсов, где N - точное обозначение референса, например GSL000434. Если в качестве значения задается список референсов, то они должны перечисляться через запятую без пробелов: GSL000434,16765,18636. Максимальное значение лимита 50.
Примеры запросов:
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&commercialRef=GSL000434
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&commercialRef=GSL000434,16765,18636
&date={N} – указывает на дату, от которой следует запросить обновленные данные. Параметр поддерживается только методами delta. Формат данных «дд.мм.гггг», например «20.04.2019».
Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltaproducts?accessCode={YourApiToken}&date=15.07.2019
Запросы можно строить с использованием нескольких параметров одновременно.
Пример запрос с использованием нескольких параметров:
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&page=2&pageSize=100
Для связи параметров используется знак апмерсанд &. Порядок указания параметров может быть в разной последовательности, на выдачу это не влияет.
&discount=1 - добавляет в выдачу метода getprice информацию о распродаже. Если референс имеет дисконтную цену, то в выдаче появляются теги <discount_start>
- дата начала распродажи и <discount_end>
- дата завершения распродажи включительно. Цена отображается уже с учетом скидки.
Для отключения действия используется значение 0.
Пример запроса информации по скидкам:
https://api.systeme.ru/new-api/XML/getprice?accessCode={YourApiToken}&discount=1
Пример выдачи со скидками:
<reference>
<commercialRef>A9C62225</commercialRef>
<description>АВТ. ВЫКЛ. REFLEX iC60N 2П 25A C Ti24</description>
<series>Acti9_Smartlink</series>
<price>4432.36</price>
<date>10.06.2019</date>
<discount_start>01.06.2019</discount_start>
<discount_end>31.08.2019</discount_end>
<unit>за штуку</unit>
</reference>
Крайне не рекомендуется работа с API напрямую. Стройте архитектуру вашего приложения таким образом, чтобы все данные сперва сохранялись в вашей БД, а уже потом использовались вами. В ином случае, излишние прямые запросы к API нагружают сервер, а при его сбое ваше приложение перестанет корректно работать.
Веб-версия базы api.systeme.ru поддерживает поиск и выгрузку некоторой продуктовой информации. На примере референса GSL000434 можно видеть наличие той или иной информации. Веб-версия не предназначена для массового получения сведений о продуктах, поэтому для получения больших объемов данных и их автоматического обновления необходимо использовать API.
Продолжая просмотр сайта www.api.systeme.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.