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

Создание черновика версии

Метод позволяет создать черновик версии и заполнить его основной информацией.

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

  • для одного приложения можно создать только один черновик. Попытка создания нескольких черновиков вызовет ошибку;
  • черновики, отправленные по API, не отображаются в веб-версии консоли разработчика. Они станут доступны после отправки APK на модерацию и при изменении статуса версии приложения;
  • создание черновика возможно только при наличии активной версии приложения;
  • отсутствующие данные в полях черновика будут взяты из активной версии приложения;
  • черновик должен соответствовать типу приложения — бесплатное или платное. В случае отправки платной версии для бесплатного приложения черновик будет обрабатываться как бесплатный;
  • для каждого типа версии приложения (appType) есть соответствующие категории версии. В случае несоответствия категории, при попытке загрузки приложения будет показана ошибка;
  • частичная публикация приложения возможна только при автоматическом (INSTANTLY) или ручном (MANUAL) типе публикации (параметр — publishType).

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

POST

https://public-api.rustore.ru/public/v1/application/{packageName}/version

АтрибутТипОбязателенРасположениеОписаниеПример
Public-TokenstringДаheaderТокен доступа к Public API Rustore.N/A
packageNamestringДаpathНаименование пакета приложения.com.myapp.example
appNamestringНетbodyНаименование версии приложения.
Максимальная длина — 5 символов
Моё приложение
appTypestringНетbodyТип версии приложения

Возможные значения:
GAMES — для игр;
MAIN — для неигровых приложений.
Передаваемые категории должны быть уникальными в рамках одного запроса.
GAMES
categoriesstringНетbodyКатегории версии.
Максимальное количество категорий — 2 категории.
"health", "news"
ageLegalstringНетbodyВозрастная категория
Возможные варианты:
18+;
16+;
12+;
7+;
3+.
7+
shortDescriptionstringНетbodyКраткое описание версии.
Максимальная длина — 80 символов.
N/A
fullDescriptionstringНетbodyПолное описание версии.
Максимальная длина — 4 000 символов
N/A
whatsNewstringНетbodyОписание «Что нового».
Максимальная длина — 500 символов
N/A
moderInfostringНетbodyКомментарий разработчика для модератора.
Максимальная длина — 180 символов.
N/A
priceValuestringНетbodyСтоимость приложения в минимальных единицах валюты (в копейках), например: «87.99 руб.» = 8799.
Значение должно быть >0.
8799
publishType
(Новый атрибут)
stringНетbodyТип публикации.

Может принимать значения:
ё — ручная публикация;
INSTANTLY — автоматическая публикация, сразу после прохождения модерации;
DELAYED — отложенная публикация.
Примечание: если параметр не указан, по умолчанию он принимается за INSTANTLY.
MANUAL
publishDateTime
(Новый атрибут)
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
(Новый атрибут)
numberНетbodyПроцент для частичной публикации приложения.
Может принимать значения:
5%;
10%;
25%;
50%;
75%
100%.
5

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

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

content{}

АтрибутТипОбязателенОписаниеПример
versionIdnumberДаВерсия приложения.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"
}