Перейти к основному содержимому

Загрузка скриншотов

Метод позволяет загрузить скриншоты приложения.

Ограничения:

  • скриншоты могут быть вертикальными или горизонтальными;
  • соотношение сторон для скриншотов — 16:9 (вертикальные) и 9:16 (горизонтальные);
  • стороны загружаемого файла — не менее 320px и не более 3840 px;
  • формат загружаемого файла — .jpg или .png;
  • размер файла — не более 3 МБ;
  • запрещена загрузка скриншотов разной ориентации. Например, пользователь загрузил вертикальную ориентацию (PORTRAIT) и хочет загрузить горизонтальную (LANDSCAPE) — запрос вернёт ошибку;
  • при загрузке более чем 10 скриншотов уже существующие скриншоты станут неактивными. Например, если загрузить два скриншота с параметром "ordinal" = 7, активным скриншотом будет последний загруженный.

Параметры взаимодействия

POST

https://public-api.rustore.ru/public/v1/application/{packageName}/version/{versionId}/image/screenshot/{orientation}/{ordinal}

АтрибутТипОбязателенРасположениеОписание
Public-TokenstringДаheaderТокен доступа к Public API Rustore.
packageNamenumberДаpathИдентификатор приложения.
versionIdnumberДаpathВерсия приложения.
orientationstringДаpathОриентация изображения.

Возможные варианты:
LANDSCAPE — горизонтальная ориентация;
PORTRAIT — вертикальная ориентация.
ordinalnumberДаpathПорядковый номер скриншота.

Возможные значения:
от 0 до 9.

Form data

АтрибутТипОбязателенОписание
filemultipart/form-dataДаФайл.

Параметры ответа

АтрибутТипОбязателенОписаниеПример
codestringДаКод ответа.error/OK
messagestringНетРасшифровка кода ответа.N/A
timestamptimestamptzДаВремя ответа.2022-07-08T13:24:41.8328711+03:00

Пример запроса

curl --location --request POST 'https://public-api.rustore.ru/public/v1/application/com.package.example/version/123/image/screenshot/landscape/1' \
--header 'Content-Type: application/json' \
--header 'Public-Token: {YOURtoken}' \
--form 'file=@"/Users/User/Downloads/img.jpg"'