Частые вопросы по API

Прочие инструкции
Расширенный контент, фото 360

Последнее обновление: 5 ноября 2020 г.

Содержание

Расширенный контент "richcontent" - getmime

Автоматическое определение ракурса изображения

Поддерживаемые параметры: commercialRef, pageSize, page, brand


Расширенный контент "richcontent" - getmime

Метод позволяет получать расширенный контент по продукции и содержит следующую информацию:

  • Названия референсов
  • Ссылки на фотографии 360
  • 3D модель
  • Каталоги
  • Техническую документацию
  • 2D схемы
  • 2D чертёжи
  • BIM модели
  • Технические статьи
  • Документы центра обучения
  • Официальные письма
  • Програмное обеспечение (дистрибутив)
  • Програмное обеспечение (обновления, дополнения, языковые пакеты)
  • Програмное обеспечение (прошивки firmware)
  • IES/LDT файлы
  • Типовые проекты
  • Паспорта на продукцию
  • Опросные листы и конфигураторы
  • Руководства
  • 3D модели
  • Видео
  • Коммерческое название
  • Коммерческое описание

Метод передает список фото 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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <update_date>16.10.2023 08:17:34</update_date>
                </ies-ldt>
            </ies-ldts>
            <guides>
                <guide>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <update_date>16.10.2024 08:17:33</update_date>
                    <keywords>
                        <keyword>Логические</keyword>
                    </keywords>
                </guide>
            </guides>
            <passports>
                <passport>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <update_date>16.10.2024 08:17:33</update_date>
                    <keywords>
                        <keyword>Паспорт</keyword>
                        <keyword>SystemePLC S250</keyword>
                    </keywords>
                </passport>
            </passports>
            <configurations>
                <configuration>
                    <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>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <update_date>16.10.2024 08:17:33</update_date>
                    <keywords>
                        <keyword>конфигуратор</keyword>
                        <keyword>SystemePLC S250</keyword>
                    </keywords>
                </configuration>
            </configurations>
            <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/>
                    <preview_hash/>
                    <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/>
                    <preview_hash/>
                    <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/>
                    <preview_image>https://static-pcsp.systeme.ru/video/QkXUv1BpVEd-kQkNvl27M3it8WpsD8gL.jpg</preview_image>
                    <preview_hash>4594085a437c6c13ef34e85c5a9365bb</preview_hash>
                    <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 файлы

guides - ссылки на файлы руководства

passports - ссылки на файлы паспорта продукции

configurations - ссылки на файлы опросных листов и конфигураторов

projects - ссылки на типовые проекты

models-3d - ссылки на 3D модели

videos - ссылки на видео. Может быть размещено на площадке Youtube, Rutube, VkVideo. Вместе с видео приходит превью стоп-кадра для "заглушки" (кроме видео размещенного в VkVideo). Обратите внимание, что одно и тоже видео может быть размещено на нескольких площадках. Параметр video_type, может приниматься значения: youtube, rutube, vk.

Если параметр не указан, по умолчанию выводятся ролики из youtube.

Примеры, запросов:

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 ракурса:

  • {номер изображения}_1 - вид фронта с левого бока
  • {номер изображения}_2 - вид фронта с правого бока
  • {номер изображения}_3 - вид сзади

Конечно, в этой логике может быть погрешность, поэтому рекомендуем вручную выборочно сверять данные, особенно если для интернет-магазина берутся только несколько фотографий с разных ракурсов.

Ошибка в тексте?

Выделите ее и нажмите

Ctrl + Enter

Продолжая просмотр сайта www.api.systeme.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.