Создание черновика версии
Метод позволяет создать черновик версии и заполнить его основной информацией.
Ограничения:
-
для одного приложения можно создать только один черновик. Попытка создания нескольких черновиков вызовет ошибку;
-
черновики, отправленные по API, не отображаются в веб-версии консоли разработчика. Они станут доступны после отправки APK на модерацию и при изменении статуса версии приложения;
-
создание черновика возможно только при наличии активной версии приложения;
-
отсутствующие данные в полях черновика будут взяты из активной версии приложения;
-
черновик должен соответствовать типу приложения — бесплатное или платное. В случае отправки платной версии для бесплатного приложения черновик будет обрабатываться как бесплатный;
-
для каждого типа версии приложения (appType) есть соответствующие категории версии. В случае несоответствия категории, при попытке загрузки приложения будет показана ошибка;
- частичная публикация приложения возможна только при автоматическом (INSTANTLY) или ручном (MANUAL) типе публикации (параметр — publishType).
Параметры взаимодействия
POST https://public-api.rustore.ru/public/v1/application/{packageName}/version
|
Атрибут |
Тип |
Обязателен |
Расположение |
Описание |
Пример заполнения |
|---|---|---|---|---|---|
|
Public-Token |
string |
Да |
header |
||
|
packageName |
string |
Да |
path |
Наименование пакета приложения
|
com.myapp.example |
|
appName |
string |
Нет |
body |
Наименование версии приложения Максимальная длина — 50 символов |
Моё приложение |
|
appType |
string |
Нет |
body |
Тип версии приложения Возможные значения: ● GAMES — для игр; ● MAIN — для неигровых приложений. Передаваемые категории должны быть уникальными в рамках одного запроса |
GAMES |
|
categories |
string |
Нет |
body |
Категории версии Максимальное количество категорий — 2 категории |
"health", "news" |
|
ageLegal |
string |
Нет |
body |
Возрастная категория Возможные варианты: ● «18+»; ● «16+»; ● «12+»; ● «7+»; ● «3+». |
7+ |
|
shortDescription |
string |
Нет |
body |
Краткое описание версии Максимальная длина — 80 символов |
|
|
fullDescription |
string |
Нет |
body |
Полное описание версии Максимальная длина — 4 000 символов |
|
|
whatsNew |
string |
Нет |
body |
Описание «Что нового» Максимальная длина — 500 символов |
|
|
moderInfo |
string |
Нет |
body |
Комментарий разработчика для модератора Максимальная длина — 180 символов |
|
|
priceValue |
string |
Нет |
body |
Стоимость приложения в минимальных единицах валюты (в копейках), например, «87.99 руб.» = 8799 Значение должно быть >0 |
8799 |
|
publishType (NEW) |
string |
Нет |
body |
Тип публикации Может принимать значения:
Примечание: если данный параметр не указан, то по умолчанию он принимается за INSTANTLY. |
MANUAL |
|
publishDateTime (NEW) |
timestamptz |
Нет Да, если publishType = DELAYED. |
body |
Дата и время для отложенной публикации: формат: yyyy-MM-dd'T'HH:mm:ssXXX. Указанная дата должна быть не раньше 24 часов и не позже 60 дней с планируемой даты отправки на модерацию. В дальнейшем дату отложенной публикации можно будет поменять. Примечание: если publishType указан MANUAL или INSTANTLY, данный параметр может быть любым и не будет учитываться. |
2022-07-08T13:24:41.8328711+03:00 |
|
partialValue (NEW) |
number |
Нет |
body |
Процент для частичной публикации приложения Может принимать значения:
|
5 |
Параметры ответа
|
Атрибут |
Тип |
Обязателен |
Описание |
Пример заполнения |
|---|---|---|---|---|
|
code |
string |
Да |
Код ответа |
error/OK |
|
message |
string |
Нет |
Расшифровка кода ответа |
|
|
timestamp |
timestamptz |
Да |
Время ответа |
2022-07-08T13:24:41.8328711+03:00 |
|
content{} |
object |
Да |
content{}
|
Атрибут |
Тип |
Обязателен |
Описание |
Пример |
|
versionId |
number |
Да |
Версия приложения |
243242 |
Пример
|
curl --location --request POST 'https://public-api.rustore.ru/public/v1/application/com.package.com/version' \ --header 'Content-Type: application/json' \ --header 'Public-Token: {YOURtoken}' \ --data-raw '{ "appName": "Приложение для RuStore", "appType": "MAIN", "categories": [ "news", "education" ], "ageLegal": "7+", "shortDescription": "Приложение для RuStore", "fullDescription": "fullDescription - Приложение для RuStore", "whatsNew": "whatsNew - Приложение для RuStore", "moderInfo": "moderInfo - Приложение для RuStore", "priceValue": 1100 }' |
Пример ответа
|
{ "code": "OK", "message": null, "body": 243242, "timestamp": "2023-07-27T10:28:59.039649+03:00" } |