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

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

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

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

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

POST

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

Атрибут	Тип	Обязателен	Расположение	Описание	Пример
Public-Token	string	Да	header	Токен доступа к Public API Rustore	N/A
packageName	string	Да	path	Наименование пакета приложения	com.myapp.example
appName	string	Нет	body	Наименование версии приложения. Максимальная длина — 5 символов	Моё приложение
appType	string	Нет	body	Тип версии приложения Возможные значения: • GAMES — для игр; • MAIN — для неигровых приложений. Передаваемые категории должны быть уникальными в рамках одного запроса	GAMES
categories	string	Нет	body	Категории версии. Максимальное количество категорий — 2 категории	"health", "news"
ageLegal	string	Нет	body	Возрастная категория Возможные варианты: • 18+; • 16+; • 12+; • 6+; • 0+	6+
shortDescription	string	Нет	body	Краткое описание версии. Максимальная длина — 80 символов	N/A
fullDescription	string	Нет	body	Полное описание версии. Максимальная длина — 4 000 символов	N/A
whatsNew	string	Нет	body	Описание «Что нового». Максимальная длина — 500 символов	N/A
moderInfo	string	Нет	body	Комментарий разработчика для модератора. Максимальная длина — 180 символов	N/A
priceValue	string	Нет	body	Стоимость приложения в минимальных единицах валюты (в копейках), например: «87.99 руб.» = 8799. Значение должно быть >0	8799
seoTagIds (Новый атрибут)	array	Нет	body	ID поисковых тегов из списка. Выбирайте теги согласно указанному appType. Все теги должны быть либо только для GAMES, либо только для MAIN. Максимальное количество — 5	[100, 102]
publishType (Новый атрибут)	string	Нет	body	Тип публикации. Может принимать значения: • MANUAL — ручная публикация; • 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

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

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

content{}

Атрибут	Тип	Обязателен	Расположение	Описание	Пример
versionId	number	Да	body	Версия приложения.	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
    "seoTagIds": [100, 102]
}' 

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

{
    "code": "OK",
    "message": null,
    "body": 243242,
    "timestamp": "2023-07-27T10:28:59.039649+03:00"
}