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

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

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

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

  • по умолчанию на каждой странице отображается по 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-TokenstringДаheaderТокен доступа к Public API Rustore.N/A
packageNamestringДаpathИмя пакета приложения.com.myapp.example
idsnumberНетqueryid конкретной версии.

Задается при необходимости получить конкретную версию.
743103
pagenumberНетqueryНомер страницы.
Начинается с 0.
0
sizenumberНетqueryКоличество отзывов на странице.
• По умолчанию — 20.
• Максимально — 100.
100

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

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

body{}

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

body.content[]

АтрибутТипОбяз.ОписаниеПример
versionIdnumberДаid версии.704372
appNamestringДаНазвание приложения.Тест API
appTypestringДаТип приложения.MAIN или GAME
versionNamestringДаНомер версии.1.0
versionCodenumberДаКод версии.6
versionStatusstringДаСтатус версии.Возможные зн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 – версия отклонена со стороны ИБ.
publishTypestringДаТип публикации.Возможные значения:
MANUAL;
INSTANTLY;
DELAYED.
publishDateTimetimestamptzДавремя отложенной публикации2023-08-04T09:36:06.431+00:00
sendDateForModertimestamptzДаВремя отправки на модерацию2023-08-11T12:03:06.303+00:00
partialValuenumberДа% для частичной публикации.-1 = 100%
Остальные значения соответвуют
whatsNewstringДаСведения об изменениях.Исправили баги
priceValuenumberДаЦена, если приложение платное.0
paidbooleanДаПлатное ли приложение.true/false

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

  • ACTIVE — версия опубликована;
  • PARTIAL_ACTIVE — версия с частичной публикацией на процент пользователей опубликована;
  • READY_FOR_PUBLICATION — версия одобрена модератором;
  • PREVIOUS_ACTIVE — предыдущая активная версия;
  • ARCHIEVED — версия находится в архиве;
  • REJECTED_BY_MODERATOR — версия отклонена модератором;
  • TAKEN_FOR_MODERATION — версия находится на модерации у модератора;
  • MODERATION — ожидает модерацию со стороны модератора;
  • AUTO_CHECK — автоматическая проверка .apk Касперским;
  • AUTO_CHECK_FAILED — автоматическая проверка не пропустила .apk;
  • DRAFT — черновик версии;
  • DELETED_DRAFT — черновик удалён;
  • REJECTED_BY_SECURITY — версия отклонена со стороны ИБ.

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

curl --location 'https://public-api.rustore.ru/public/v1/application/com.example.pblsh_v2/version?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",
"publishDateTime": "2023-08-14T12:34:43.925+00:00",
"sendDateForModer": "2023-08-11T12:03:06.303+00:00",
"partialValue": -1,
"whatsNew": "Исправили баги",
"priceValue": 0,
"paid": false
},
{
"versionId": 704197,
"appName": "PO test API",
"appType": "MAIN",
"versionName": "1.0",
"versionCode": 1,
"versionStatus": "PREVIOUS_ACTIVE",
"publishType": "INSTANTLY",
"publishDateTime": "2023-08-04T09:36:06.431+00:00",
"sendDateForModer": "2023-08-04T09:20:23.551+00:00",
"partialValue": -1,
"whatsNew": "Первая версия",
"priceValue": 0,
"paid": false
}
],
"pageNumber": 0,
"pageSize": 2,
"totalElements": 2,
"totalPages": 1
},
"timestamp": "2023-08-14T15:38:50.413186769+03:00"
}