Содержание

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

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

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

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

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

Названия референсов
Ссылки на фотографии 360
Фото в интерьере
Инфографику
Статьи
Видео
Коммерческое название
Коммерческое описание

Метод передает список фото 360 в правильной последновательности, из которых можно собрать воспроизведение в плеере на стороне разработчика. Встроенный плеер на данный момент недоступен для подключения.

Пример запроса:
https://api.systeme.ru/new-api/XML/getmime?accessCode={YourApiToken}

Пример ответа:

<reference>
<commercialRef>GSL000151</commercialRef>
<enviromental_img>
<image>
<url>
https://http://static-pcsp.systeme.ru/photo_interior/50584/n6lba1kX4xMPdID.jpg
</url>
<size>1264824</size>
<type>jpg</type>
</image>
<image>
<url>
https://http://static-pcsp.systeme.ru/photo_interior/50584/FrlmgsjT4Vj6wQR.jpg
</url>
<size>15506704</size>
<type>jpg</type>
</image>
<image>
<url>
https://http://static-pcsp.systeme.ru/photo_interior/50584/9rFHINl7e2hOPVq.jpg
</url>
<size>9899172</size>
<type>jpg</type>
</image>
</enviromental_img>
<infographic/>
<articles/>
<videos/>
<eComProductTitles/>
<eComeProductDescriptions>
Механизм Glossa (цвет белый) выключателя 2-клавишного подходит для сетей 250 В, на ток 10 А. - Двухклавишный выключатель позволяет управлять двумя источниками света с одной точки. - Выполнен из материала PС+ASA, стойкого к УФ-излучению и появлению царапин. - Эргономичные клеммы расположены в два ряда: сверху и снизу.
</eComeProductDescriptions>
<typical_BOM/>
</reference>

enviromental_img - ссылки на изображения в интерьере, расширение jpg.

infographic - ссылки на элементы инфографики jpg, png, pdf

articles - ссылки на статьи в pdf формате

videos - ссылки на видеоролики в 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>
...

У референсов количество фотографий 360 в выдаче может быть разным, например 36 или 60 штук. Это является особенностью съемки.

Размер изображений указан в Байтах.

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

Дополнительно у фотографий указывается тег num, который передает порядковый номер изображения в выдаче для правильного восстановления хронологии воспроизведения. Этот номер состоит из двух частей, например 2_1. Первое значение является порядковым номером, а второе - принадлежность в ракурсу. И чем дальше вторая цифра от начала нумерации указанного ракурса, тем изображение будет более повернуто к другой стороне. Так, 2_1 будет ближе к ракурсу "вид фронта с левого бока", чем изображение под номером 2_9.

Процесс съемки фотографий 360 всегда представляет собой одинаковый процесс: предмет располагают в центр и начинают съемку с одного и того же ракурса. Предполагается, что при наличии одинакового количества фотографий 360 (например, 36 штук) у двух референсов, один и тот же порядковый номер будет иметь примерно одинаковый ракурс. На основании этого система автоматически определяет принадлежность изображений к ракурсу и помечает его дополнительной цифрой.

Всего определяется 3 ракурса:

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

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