Getting Application Version Status
This method allows you to retrieve basic version information and check the status of specific versions.
Limitations:
- By default, 20 versions are shown per page. You can request up to 100 versions per page using the
size
parameter. - You cannot use pagination and filtering by version ID at the same time — use either pagination (
page
+size
) or version filter (ids
).
Request Parameters
GET
https://public-api.rustore.ru/public/v1/application/{packageName}/version?ids=704095&page=0&size=2
Attribute | Type | Required | Location | Description | Example |
---|---|---|---|---|---|
Public-Token | string | Yes | header | Access token for the Rustore Public API. | N/A |
packageName | string | Yes | path | App package name. | com.myapp.example |
ids | number | No | query | Version ID to fetch a specific version. | 743103 |
New filterTestingType | string | No | query | Application version type. Allowed values: • ALL – all release and alpha versions; • RELEASE – default, only published versions; • ALPHA – only alpha test versions. | |
page | number | No | query | Page number (starts at 0 ). | 0 |
size | number | No | query | Number of versions per page. • Default — 20 ; • Max — 100 . | 100 |
Response Parameters
Attribute | Type | Required | Description | Example |
---|---|---|---|---|
code | string | Yes | Response code. | OK / error |
message | string | No | Explanation of the response code. | N/A |
timestamp | timestamptz | Yes | Response timestamp. | 2022-07-08T13:24:41.8328711+03:00 |
body{} | object | Yes | Response body. | N/A |
body{}
Attribute | Type | Required | Description | Example |
---|---|---|---|---|
content[] | array | Yes | List of versions. | N/A |
pageNumber | number | Yes | Current page number. | 0 |
pageSize | number | Yes | Page size. | 2 |
totalElements | number | Yes | Total number of elements. | 5 |
totalPages | number | Yes | Total number of pages. | 3 |
body.content[]
Attribute | Type | Required | Description | Example |
---|---|---|---|---|
versionId | number | Yes | Version ID. | 704372 |
appName | string | Yes | Application name. | Test API |
appType | string | Yes | App type. | MAIN or GAME |
versionName | string | Yes | Version number. | 1.0 |
versionCode | number | Yes | Version code. | 6 |
versionStatus | string | Yes | Version status. Possible values: • ACTIVE – published; • PARTIAL_ACTIVE – partially published to a subset of users; • READY_FOR_PUBLICATION – approved by moderator; • PREVIOUS_ACTIVE – previous active version; • ARCHIVED – archived; • REJECTED_BY_MODERATOR – rejected by moderator; • TAKEN_FOR_MODERATION – taken by moderator; • MODERATION – awaiting moderation; • AUTO_CHECK – antivirus auto-check (Kaspersky); • AUTO_CHECK_FAILED – failed antivirus check; • DRAFT – draft version; • DELETED_DRAFT – deleted draft; • REJECTED_BY_SECURITY – rejected by security. | |
publishType | string | Yes | Publication type. Allowed values: • MANUAL • INSTANTLY • DELAYED | |
New testingType | string | Yes | Version testing type. Possible values: • null – release; • alpha – alpha version. | |
publishDateTime | timestamptz | Yes | Scheduled publication time. | 2023-08-04T09:36:06.431+00:00 |
sendDateForModer | timestamptz | Yes | Time sent for moderation. | 2023-08-11T12:03:06.303+00:00 |
partialValue | number | Yes | Percentage of users for partial release. -1 = 100% | -1 |
whatsNew | string | Yes | What's new in this version. | Bug fixes |
priceValue | number | Yes | Price (if paid). | 0 |
paid | boolean | Yes | Is the app paid? | true / false |
Request Example
curl --location 'https://public-api.rustore.ru/public/v1/application/com.example.pblsh_v2/version?filterTestingType=ALPHA&page=0&size=2' \
--header 'accept: application/json' \
--header 'Public-Token: {YOURtoken}'
Response Example
{
"code": "OK",
"message": null,
"body": {
"content": [
{
"versionId": 704372,
"appName": "Test API",
"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": -1,
"whatsNew": "Bug fixes",
"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": -1,
"whatsNew": "First version",
"priceValue": 0,
"paid": false
}
],
"pageNumber": 0,
"pageSize": 2,
"totalElements": 2,
"totalPages": 1
},
"timestamp": "2023-08-14T15:38:50.413186769+03:00"
}