Получение статуса версий приложений

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

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

по умолчанию на каждой странице отображается по 20 версий, вы можете отображать до 100 версий на странице, указав значение в параметре size;
совместно использовать параметры пагинации и фильтрации по 1 версии — нельзя (либо пагинация с указанием пары параметров page и size либо ids).

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

GET

https://public-api.rustore.ru/public/v1/application/{packageName}/version?ids=704095&page=0&size=2

Атрибут	Тип	Обязательность	Расположение	Описание	Пример
`Public-Token`	string	Да	header	Токен доступа к Public API Rustore.	N/A
`packageName`	string	Да	path	Имя пакета приложения.	`com.myapp.example`
`ids`	number	Нет	query	`id` конкретной версии. Задается при необходимости получить конкретную версию.	`743103`
New`versionStatuses`	string	Нет	query	Список статусов версий для фильтрации, переданные через запятую. Если параметр не указан, выводятся версии во всех статусах.	`ACTIVE,DRAFT`
New`filterTestingType`	string	Нет	query	Тип версии приложения.	Возможные знaчения: •`ALL` – выводятся все версии со значением release и alpha; •`RELEАSE` – значение по умолчанию, выводятся только опубликованные на пользователей версии; • `ALPHA` – выводятся только публикуемые в качестве альфа-тестирования версии.
`page`	number	Нет	query	Номер страницы. Начинается с `0`.	`0`
`size`	number	Нет	query	Количество версий на странице. • По умолчанию — `20`. • Максимально — `100`.	`100`

Возможные значения статусов версий

ACTIVE: Опубликована и доступна пользователям.
PARTIAL_ACTIVE: Опубликована для части пользователей (поэтапное развертывание).
READY_FOR_PUBLICATION: Одобрена модерацией, ожидает публикации (ручной или отложенной).
PREVIOUS_ACTIVE: Предыдущая опубликованная версия приложения.
ARCHIVED: Перемещена в архив разработчиком, недоступна пользователям.
REJECTED_BY_MODERATOR: Отклонена модератором по результатам проверки.
TAKEN_FOR_MODERATION: Принята на модерацию, находится в очереди или на начальном этапе проверки.
MODERATION: Находится на активном рассмотрении модератора.
AUTO_CHECK: Проходит автоматическую проверку.
AUTO_CHECK_FAILED: Автоматическая проверка не пройдена.
DRAFT: Черновик версии, не отправленный на модерацию.
DELETED_DRAFT: Удаленный черновик версии.
REJECTED_BY_SECURITY: Отклонена службой безопасности.

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

Атрибут	Тип	Обязательность	Описание	Пример
`code`	string	Да	Код ответа.	`error`/`OK`
`message`	string	Нет	Расшифровка кода ответа.	N/A
`timestamp`	timestamptz	Да	Время ответа.	`2022-07-08T13:24:41.8328711+03:00`
`body{}`	object	Да	N/A	N/A

`body{}`

Атрибут	Тип	Обязательность	Описание	Пример
`content[]`	massive	Да	Массив, содержащий список версий.	N/A
`pageNumber`	number	Да	Номер текущей страницы.	`0`
`pageSize`	number	Да	Размер страницы.	`2`
`totalElements`	number	Да	Всего элементов.	`5`
`totalPages`	number	Да	Всего страниц.	`3`

`body.content[]`

Атрибут	Тип	Обязательность	Описание	Пример
`versionId`	number	Да	`id` версии.	`704372`
`appName`	string	Да	Название приложения.	`Тест API`
`appType`	string	Да	Тип приложения.	`MAIN` или `GAME`
`versionName`	string	Да	Номер версии.	`1.0`
`versionCode`	number	Да	Код версии.	`6`
`versionStatus`	string	Да	Статус версии.	Возможные знaчения: • `ACTIVE` – версия опубликована; • `PARTIAL_ACTIVE` – версия опубликована на заданный процент пользователей; • `READY_FOR_PUBLICATION` – версия одобрена модератором; `PREVIOUS_ACTIVE` – предыдущая активная версия; • `ARCHIVED` – версия находится в архиве, • `REJECTED_BY_MODERATOR` – версия отклонена модератором; • `TAKEN_FOR_MODERATION` – версия находится на модерации; • `MODERATION` – версия ожидает действий от модератора; • `AUTO_CHECK` – автоматическая проверка антивирусом Касперского; • `AUTO_CHECK_FAILED` – автоматическая проверка не пропустила APK; • `DRAFT` – черновик версии; • `DELETED_DRAFT` – черновик удалён; • `REJECTED_BY_SECURITY` – версия отклонена со стороны ИБ.
`publishType`	string	Да	Тип публикации.	Возможные значения: • `MANUAL`; • `INSTANTLY`; • `DELAYED`.
New`filterTestingType`	string	Да	Тип версии приложения.	Возможные значения: • `null` – релизная версия; • `alpha` – альфа-версия.
`publishDateTime`	timestamptz	Да	время отложенной публикации	`2023-08-04T09:36:06.431+00:00`
`sendDateForModer`	timestamptz	Да	Время отправки на модерацию	`2023-08-11T12:03:06.303+00:00`
`partialValue`	number	Да	% для частичной публикации.	100
`whatsNew`	string	Да	Сведения об изменениях.	`Исправили баги`
`priceValue`	number	Да	Цена, если приложение платное.	`0`
`paid`	boolean	Да	Платное ли приложение.	`true`/`false`

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

curl --location 'https://public-api.rustore.ru/public/v1/application/com.example.pblsh_v2/version?versionStatuses=ACTIVE,DRAFT&filterTestingType=ALPHA&page=0&size=2' \
--header 'accept: application/json' \
--header 'Public-Token: {YOURtoken}’

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

{
    "code": "OK",
    "message": null,
    "body": {
        "content": [
            {
                "versionId": 704372,
                "appName": "Тест АПИ",
                "appType": "MAIN",
                "versionName": "1.0",
                "versionCode": 6,
                "versionStatus": "ACTIVE",
                "publishType": "MANUAL",
                "testingType": alpha,
                "publishDateTime": "2023-08-14T12:34:43.925+00:00",
                "sendDateForModer": "2023-08-11T12:03:06.303+00:00",
                "partialValue": 100,
                "whatsNew": "Исправили баги",
                "priceValue": 0,
                "paid": false
            },
            {
                "versionId": 704197,
                "appName": "PO test API",
                "appType": "MAIN",
                "versionName": "1.0",
                "versionCode": 1,
                "versionStatus": "PREVIOUS_ACTIVE",
                "publishType": "INSTANTLY",
                "testingType": alpha,
                "publishDateTime": "2023-08-04T09:36:06.431+00:00",
                "sendDateForModer": "2023-08-04T09:20:23.551+00:00",
                "partialValue": 100,
                "whatsNew": "Первая версия",
                "priceValue": 0,
                "paid": false
            }
        ],
        "pageNumber": 0,
        "pageSize": 2,
        "totalElements": 2,
        "totalPages": 1
    },
    "timestamp": "2023-08-14T15:38:50.413186769+03:00"
}

Получение статуса версий приложений

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

Возможные значения статусов версий​

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

body{}​

body.content[]​

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

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