Последнее обновление: 5 ноября 2020 г.
Расширенный контент "richcontent" - getmime
Автоматическое определение ракурса изображения
Поддерживаемые параметры: commercialRef, pageSize, page, brand
Метод позволяет получать расширенный контент по продукции и содержит следующую информацию:
Метод передает список фото 360 в правильной последновательности, из которых можно собрать воспроизведение в плеере на стороне разработчика. Также доступен встроенный плеер, который возможно разместить на своей странице.
Пример запроса:
https://api.systeme.ru/new-api/XML/getmime?accessCode={YourApiToken}
Пример ответа:
<content>
<result>success</result>
<data>
<reference>
<commercialRef>SM252MESC</commercialRef>
<update_date>30.08.2023 13:46:28</update_date>
<photo360>
<url>https://api.systeme.ru/player/embed?ref=ATV310HU40N4E</url>
</photo360>
<catalogs>
<catalog>
<url>https://api.systeme.ru/product/media/download/988188</url>
<filename>Каталог SystemePLC S250.pdf</filename>
<title>Каталог SystemePLC S250</title>
<description>Каталог SystemePLC S250</description>
<size>9648268</size>
<hash>6fa76c7e379bdf190592891006b611f8204e81e2</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/sk_r-GbnUoqkwn.jpg
</preview_img>
<update_date>16.10.2023 08:17:33</update_date>
<keywords>
<keyword>Логические</keyword>
<keyword>контроллеры</keyword>
<keyword>питания</keyword>
</keywords>
</catalog>
</catalogs>
<techdocs>
<techdoc>
<url>https://api.systeme.ru/product/media/download/988187</url>
<filename>Руководство пользователя контроллеров SM250.pdf</filename>
<title>Руководство пользователя контроллеров SM250</title>
<description>Настоящее руководство по эксплуатации распространяется на аналоговые
модули расширения торговой марки Systeme Electric, серии SystemePLC.
</description>
<size>11922551</size>
<hash>a2b925a057e9f13b2c657e2dba8ed1e3a0023740</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/NnI5gJ3JgFinQ_8DFIY.jpg
</preview_img>
<update_date>16.10.2023 08:17:33</update_date>
<keywords>
<keyword>Логические</keyword>
<keyword>контроллеры</keyword>
<keyword>дискретные</keyword>
<keyword>счетный</keyword>
<keyword>коммуникационные</keyword>
<keyword>питания</keyword>
</keywords>
</techdoc>
<techdoc>
<url>https://api.systeme.ru/product/media/download/988210</url>
<filename>SystemePLC SM252MESC SM253CE10 модули круководство.pdf</filename>
<title>SystemePLC SM252MESC SM253CE10 модули контроллера - руководство</title>
<description>Настоящее руководство по эксплуатации распространяется на аналоговые
модули расширения торговой марки Systeme Electric, серии SystemePLC.
</description>
<size>300698</size>
<hash>4232b3fe20bad4c6259a47e3a6cf907441ab8ec0</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/nBFtgMf2rqJRikvaKjdXfE.jpg
</preview_img>
<update_date>16.10.2023 08:18:07</update_date>
<keywords>
<keyword>модуль</keyword>
<keyword>контроллера</keyword>
<keyword>логический</keyword>
</keywords>
</techdoc>
</techdocs>
<tech-articles>
<article>
<url>https://api.systeme.ru/product/media/download/988189</url>
<filename>Вопросы и ответы по Systeme PLC S250.pdf</filename>
<title>Вопросы и ответы по Systeme PLC S250</title>
<description>Часто задаваемые вопросы и ответы по Systeme PLC S250</description>
<size>2481300</size>
<hash>35d83b578900a39177d09eff8ef6c3448b09f274</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/-PA2NRQ84UKvAbpjw7Ixd.jpg
</preview_img>
<update_date>16.10.2023 08:17:34</update_date>
</article>
</tech-articles>
<edu-documentations>
<edu-documentation>
<url>https://api.systeme.ru/product/media/download/9881</url>
<filename>Документы центра обучения.pdf</filename>
<title>Документы центра обучения</title>
<description>Описание документа центра обучения</description>
<size>248130</size>
<hash>35d83b578900a39177d09eff8ef6c3448b09f274</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/-PA2NRQ84UKvAbpj2w7Ixd.jpg
</preview_img>
<update_date>16.10.2023 08:17:34</update_date>
</edu-documentation>
</edu-documentations>
<letters>
<letter>
<url>https://api.systeme.ru/product/media/download/98281</url>
<filename>Официальные письма.pdf</filename>
<title>Официальные письма</title>
<description>Описание официального письма</description>
<size>24830</size>
<hash>35d83b578900a3917709eff8ef6c3448b09f274</hash>
<type>pdf</type>
<preview_img>
https://static-pcsp.systeme.ru/media_preview/media/PA2NRQ84UKvAbpj2w7Ixd.jpg
</preview_img>
<update_date>16.10.2023 08:17:34</update_date>
</letter>
</letters>
<schemes>
<scheme>
<url>https://api.systeme.ru/product/media/download/981</url>
<filename>Cсылки на 2D схемы.pdf</filename>
<title>ссылки на 2D схемы</title>
<description>Описание 2D схемы</description>
<size>248320</size>
<hash>35d83b578900a39177d09eff8ef346c3448b09f274</hash>
<type>pdf</type>
<preview_img/>
<update_date>16.11.2023 08:17:34</update_date>
</scheme>
</schemes>
<drawings>
<drawing>
<url>https://api.systeme.ru/product/media/download/988195</url>
<filename>CAD файлы SystemePLC S250 в формате DWG.zip</filename>
<title>CAD файлы SystemePLC S250 в формате DWG</title>
<description>CAD файлы SystemePLC S250 в формате DWG</description>
<size>9139395</size>
<hash>bf60e42b87872cad6ece33a479afefd09842145f</hash>
<type>zip</type>
<preview_img/>
<update_date>16.10.2023 08:18:06</update_date>
</drawing>
</drawings>
<bim-models>
<bim-model>
<url>https://api.systeme.ru/product/media/download/92194</url>
<filename>CODESYS3.5SP11.zip</filename>
<title>ПО CODESYS3.5SP11</title>
<description>ПО CODESYS 3.5SP11</description>
<size>1069512453</size>
<hash>3a1b694504df8a8b2a5f126cd81ea7ccbc86d74a</hash>
<type>zip</type>
<preview_img/>
<update_date>16.10.2023 08:18:06</update_date>
</bim-model>
</bim-models>
<distributions>
<distribution>
<url>https://api.systeme.ru/product/media/download/988194</url>
<filename>CODESYS 3.5SP11(Win64).zip</filename>
<title>ПО CODESYS 3.5SP11 (Win64)</title>
<description>ПО CODESYS 3.5SP11 (Win64)</description>
<version>1.0</version>
<size>1069512453</size>
<hash>3a1b694504df8a8b2a5f126cd81ea7ccbc86d74a</hash>
<type>zip</type>
<preview_img/>
<update_date>16.10.2023 08:18:06</update_date>
</distribution>
</distributions>
<update-kits>
<update-kit>
<url>https://api.systeme.ru/product/media/download/988190</url>
<filename>Targets.zip</filename>
<title>Таргет файлы</title>
<description>Таргет файлы</description>
<version>2.0</version>
<size>124263</size>
<hash>c264dc5a62ab9d169e392042556682f320783cdf</hash>
<type>zip</type>
<preview_img/>
<update_date>16.10.2023 08:17:34</update_date>
</update-kit>
</update-kits>
<firmwares>
<firmware>
<url>https://api.systeme.ru/product/media/download/982190</url>
<filename>firmware.zip</filename>
<title>firmware</title>
<description>firmware</description>
<version>2.0</version>
<size>124263</size>
<hash>c264dc5a62ab9d169e392042556682f320783cdf</hash>
<type>zip</type>
<preview_img/>
<update_date>16.10.2023 08:17:34</update_date>
</firmware>
</firmwares>
<ies-ldts>
<ies-ldt>
<url>https://api.systeme.ru/product/media/download/382190</url>
<filename>IES/LDT.ies</filename>
<title>Файл IES/LDT</title>
<description>Файл IES/LDT</description>
<size>124263</size>
<hash>c264dc5a62ab9d169e392042556682f320783cdf</hash>
<type>ies</type>
<preview_img/>
<update_date>16.10.2023 08:17:34</update_date>
</ies-ldt>
</ies-ldts>
<projects>
<project>
<url>https://api.systeme.ru/product/media/download/382190</url>
<filename>projects.zip</filename>
<title>Файл типового проекта</title>
<description>Файл типового проекта</description>
<size>1243263</size>
<hash>c264dc5a62ab9d169e392042556682f320783cdf</hash>
<type>яшз</type>
<preview_img/>
<update_date>16.10.2023 08:17:34</update_date>
</project>
</projects>
<models-3d>
<model-3d>
<url>https://api.systeme.ru/product/media/download/773</url>
<filename>fan_vw3g22400.3dxml</filename>
<title/>
<description/>
<size>129589</size>
<hash>d22f1bdc9f00c2a7fce243bc458c62cf22d83972</hash>
<type>3dxml</type>
<preview_img/>
<update_date>18.01.2021 18:01:26</update_date>
</model-3d>
</models-3d>
<videos>
<video>
<url>https://www.youtube.com/watch?v=fC_odSh4EFk</url>
<title>ATV600 - ATV900 Cброс конфигурации на заводские настройки</title>
<description/>
<update_date/>
</video>
</videos>
<eComProductTitles>Преобразователь частоты ATV630 37кВт 380В 3ф</eComProductTitles>
<eComeProductDescriptions><p>Преобразователь 37кВт 380В 3ф</p></eComeProductDescriptions>
</reference>
</data>
</content>
catalogs - ссылки на элементы каталогов
techdocs - ссылки на техническую документацию
schemes - ссылки на 2D схемы
drawings - ссылки 2D чертёжи
bim-models - ссылки на BIM модели
tech-articles - ссылки на технические статьи
edu-documentations - ссылки на документы центра обучения
letters - ссылки на официальные письма
distributions - ссылки на програмное обеспечение (дистрибутив)
update-kits - ссылки на програмное обеспечение (обновления, дополнения, языковые пакеты)
firmwares - ссылки на програмное обеспечение(прошивки firmware)
ies-ldts - ссылки на IES/LDT файлы
projects - ссылки на типовые проекты
models-3d - ссылки на 3D модели
eComProductTitles - коммерческое название референса
eComeProductDescriptions - коммерческое описание референса, приходит в неформатированном виде. Для корректного оторбажения требуется дополнительная разметка на стороне партнера.
Для получения списка всех фотографий 360, которые используются в плеере, в запрос необходимо добавлять параметр &images=1. В ответе дополнительно к основному списку контента будут добавлены и фотографии в теге images.
Пример запроса:
https://api.systeme.ru/new-api/XML/getmime?accessCode={YourApiToken}&images=1
Пример ответа:
<reference>
<commercialRef>GSL000151</commercialRef>
<photo360>
<images>
<image>
<num>1_1</num>
<url>
https://static-pcsp.systeme.ru/player_360/50584/001.jpg
</url>
<size>64219</size>
<type>jpg</type>
</image>
<image>
<num>2_1</num>
<url>
https://static-pcsp.systeme.ru/player_360/50584/002.jpg
</url>
<size>63786</size>
<type>jpg</type>
</image>
</images>
</photo360>
</reference>
У референсов количество фотографий 360 в выдаче может быть разным, например 36 или 60 штук. Это является особенностью съемки.
Размер изображений указан в Байтах.
Дополнительно у фотографий указывается тег num\, который передает порядковый номер изображения в выдаче для правильного восстановления хронологии воспроизведения. Этот номер состоит из двух частей\, например 2_1. Первое значение является порядковым номером\, а второе - принадлежность в ракурсу. И чем дальше вторая цифра от начала нумерации указанного ракурса\, тем изображение будет более повернуто к другой стороне. Так\, 2_1 будет ближе к ракурсу "вид фронта с левого бока"\, чем изображение под номером 2_9.
Процесс съемки фотографий 360 всегда представляет собой одинаковый процесс: предмет располагают в центр и начинают съемку с одного и того же ракурса. Предполагается, что при наличии одинакового количества фотографий 360 (например, 36 штук) у двух референсов, один и тот же порядковый номер будет иметь примерно одинаковый ракурс. На основании этого система автоматически определяет принадлежность изображений к ракурсу и помечает его дополнительной цифрой.
Всего определяется 3 ракурса:
Конечно, в этой логике может быть погрешность, поэтому рекомендуем вручную выборочно сверять данные, особенно если для интернет-магазина берутся только несколько фотографий с разных ракурсов.
Продолжая просмотр сайта www.api.systeme.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.