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

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

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

• для одного приложения можно создать только один черновик. Попытка создания нескольких черновиков вызовет ошибку;
• черновики, отправленные по 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
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
}' 

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

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