Загрузка скриншотов v2
Метод позволяет загрузить скриншоты для любого типа устройств, в том числе для планшета и ТВ.
Ограничения:
- скриншоты могут быть вертикальными или горизонтальными;
- соотношение сторон для скриншотов — 16:9 (горизонтальные) и 9:16 (вертикальные);
- стороны загружаемого файла — не менее 320px и не более 3840 px;
- формат загружаемого файла —
.jpgили.png; - размер файла — не более 5 МБ;
- минимальное количество скриншотов для публикации — 3;
- при несоответствии соотношения сторон возвращается предупреждение;
- запрещена загрузка скриншотов разной ориентации. Например, пользователь загрузил вертикальную ориентацию (
PORTRAIT) и хочет загрузить горизонтальную (LANDSCAPE) — запрос вернет ошибку; - при загрузке более чем 10 скриншотов уже существующие скриншоты станут неактивными. Например, если загрузить два скриншота с параметром
"ordinal" = 7, активным скриншотом будет последний загруженный.
Параметры взаимодействия
POST
/public/v2/application/{packageName}/version/{versionId}/image/screenshot/{orientation}/{ordinal}/{type}
| Атрибут | Тип | Обязателен | Расположение | Описание |
|---|---|---|---|---|
Public-Token | string | Да | header | Токен доступа к Public API Rustore. |
packageName | string | Да | path | Идентификатор пакета приложения. |
versionId | integer | Да | path | Идентификатор версии. |
orientation | string | Да | path | Ориентация изображения. Возможные варианты: • PORTRAIT — вертикальная ориентация; • LANDSCAPE — горизонтальная ориентация. |
ordinal | integer | Да | path | Порядковый номер скриншота. Возможные значения: от 0 до 9. |
type | string | Да | path | Тип устройства: • SCREENSHOT; • TABLET_SCREENSHOT; • TV_SCREENSHOT. |
Тело запроса
Запрос должен быть в формате multipart/form-data.
| Атрибут | Тип | Обязателен | Описание |
|---|---|---|---|
file | binary | Да | Файл скриншота в формате .jpg или .png. Максимальный размер файла — 5 МБ. |
Параметры ответа
| Атрибут | Тип | Обязателен | Описание | Пример |
|---|---|---|---|---|
code | string | Да | Код ответа. | OK/ERROR |
message | string | Нет | Расшифровка кода ответа. | Successful result |
timestamp | string | Да | Время ответа. | 2026-07-27T15:00:59.815Z |
body.id | integer | Нет | Идентификатор скриншота. | 123 |
body.fileUrl | string | Нет | Ссылка на загруженный файл. | https://... |
body.ordinal | integer | Нет | Порядковый номер скриншота. | 1 |
body.type | string | Нет | Тип устройства. | SCREENSHOT |
body.fileUid | string | Нет | Уникальный идентификатор файла. | abc-123 |
body.orientation | string | Нет | Ориентация скриншота. | PORTRAIT |
Пример запроса
curl --location --request POST 'https://public-api.rustore.ru/public/v2/application/com.package.example/version/123/image/screenshot/PORTRAIT/1/SCREENSHOT' \
--header 'Content-Type: application/json' \
--header 'Public-Token: {YOURtoken}' \
--form 'file=@"/Users/User/Downloads/screenshot.jpg"'
Пример ответа
{
"code": "OK",
"message": "Successful result",
"body": {
"id": 123,
"fileUrl": "https://storage.rustore.ru/screenshots/123.jpg",
"ordinal": 1,
"type": "SCREENSHOT",
"fileUid": "abc-123-def",
"orientation": "PORTRAIT"
},
"timestamp": "2026-07-27T15:00:59.815Z"
}
Коды ошибок
| Код | Описание |
|---|---|
| 400 | Bad Request — неверный запрос |
| 401 | Unauthorized — требуется авторизация |
| 403 | Forbidden — доступ запрещен |
| 404 | Not Found — ресурс не найден |
| 500 | Internal Server Error — внутренняя ошибка сервера |