Метод получения данных подписки по токену подписки (V2)
Метод позволяет получить информацию о подписке по токену подписки.
Параметры взаимодействия
GET https://public-api.rustore.ru/public/glike/subscription/{packageName}/{subscriptionId}/{subscriptionToken}
Атрибут |
Тип |
Описание |
Обязательность |
Расположение |
Пример заполнения |
---|---|---|---|---|---|
Public-Token |
string |
Токен доступа к Public API Rustore |
Да |
header |
|
packageName |
string |
Наименование пакета приложения |
Да |
path |
|
subscriptionId |
string |
Код продукта-подписки |
Да |
path |
|
subscriptionToken |
string |
Да |
path |
111.123 |
Параметры успешного ответа
Атрибут |
Тип |
Описание |
Обязательность |
Пример заполнения |
---|---|---|---|---|
startTimeMillis |
string |
Время предоставления подписки в миллисекундах с начала эпохи. |
да |
1577826955637 |
expiryTimeMillis |
string |
Время истечения срока действия подписки в миллисекундах с начала эпохи. |
да |
1609456386128 |
autoRenewing |
boolean |
Будет ли подписка автоматически продлеваться по истечении текущего срока действия. |
да |
false |
priceCurrencyCode |
string |
Код валюты ISO 4217 для цены подписки. |
да |
RUB |
priceAmountMicros |
string |
Цена подписки. Цена выражается в микроединицах, где 1 000 000 микроединиц представляет собой одну единицу валюты. Например, если цена подписки составляет 1,99 евро, ценаAmountMicros равна 1990000. |
да |
749000000 |
countryCode |
string |
Код страны/региона выставления счетов пользователя на момент предоставления подписки. |
да |
RU |
paymentState |
int |
Состояние оплаты подписки. Возможные значения: 0. Ожидание платежа 1. Получение платежа 2. Бесплатная пробная версия 3. Ожидание отложенного обновления/понижения. Отсутствует для отмененных подписок с истекшим сроком действия. |
нет, только для активных подписок |
1 |
cancelReason |
int |
Причина, по которой подписка была отменена или не продлевается автоматически. Возможные значения: 0. Пользователь отменил подписку 1. Подписка была отменена системой, например, из-за проблемы с оплатой 2. Подписка заменена новой подпиской 3. Подписка отменена разработчиком |
нет, только для отмененных подписок со статусом CLOSED |
0 |
orderId |
string |
Идентификатор счета для последнего повторяющегося заказа, связанного с покупкой подписки. Если подписка была отменена из-за отклонения платежа, это будет идентификатор счета с отклоненным платежом. Если счетов по подписке более одного, к идентификатору добавляется их количество через разделитель ".." |
да |
41456..3 |
acknowledgementState |
int |
Состояние подтверждения продукта подписки. Возможные значения: 0. Ещё не подтверждено 1. Подтверждено |
да |
1 |
introductoryPriceInfo{} |
object |
Информация о промо периоде подписки. Это поле не указывает, что подписка в настоящее время находится в промо периоде. |
нет, только для подписок с периодом PROMO |
|
kind |
string |
Всегда передаётся значение "androidpublisher#subscriptionPurchase" |
да |
androidpublisher#subscriptionPurchase |
purchaseType |
int |
Всегда передаётся значение "0" |
да |
0 |
introductoryPriceInfo{}
Атрибут |
Тип |
Описание |
Обязательность |
Пример заполнения |
---|---|---|---|---|
introductoryPriceCurrencyCode |
string |
Код валюты ISO 4217 для начальной цены подписки |
нет, только для подписок с периодом PROMO |
RUB |
introductoryPriceAmountMicros |
string |
Начальная цена подписки. Валюта совпадает с priceCurrencyCode. Цена выражается в микроединицах, где 1 000 000 микроединиц представляет собой одну единицу валюты. Например, если цена подписки составляет 1,99 евро, ценаAmountMicros равна 1990000. |
нет, только для подписок с периодом PROMO |
599000000 |
introductoryPricePeriod |
string |
Период начальной цены, указанный в формате ISO 8601. Например, «P1W» (одна неделя), «P1M» (один месяц), «P3M» (три месяца), «P6M» (шесть месяцев) и «P1Y» (один год). |
нет, только для подписок с периодом PROMO |
P1Y |
introductoryPriceCycles |
string |
Количество расчетных периодов для предложения начальной цены. |
нет, только для подписок с периодом PROMO |
1 |
Пример ответа в JSON
{ "startTimeMillis": "1694431707000", "expiryTimeMillis": "1697034507000", "autoRenewing": true, "priceCurrencyCode": "RUB", "priceAmountMicros": "749000000", "countryCode": "RU", "paymentState": 1, "orderId": "33252..1", "acknowledgementState": 1, "kind": "androidpublisher#subscriptionPurchase", "purchaseType": 0, "introductoryPriceInfo": { "introductoryPriceCurrencyCode": "RUB", "introductoryPriceAmountMicros": "599000000 ", "introductoryPricePeriod": "P1M", "introductoryPriceCycles": "1" } } |
Параметры ошибочного ответа
Атрибут |
Тип |
Описание |
Обязательность |
Пример заполнения |
---|---|---|---|---|
error{} |
object |
Объект с данными ошибки |
Да, если код ответа !=200 |
error{}
Атрибут |
Тип |
Описание |
Обязательность |
Пример заполнения |
---|---|---|---|---|
code |
number |
http-код ответа |
Да |
|
message |
date |
Расшифровка кода ответа |
Нет |
message
code |
message |
---|---|
400 | The subscription purchase token does not match the subscription ID. |
404 | No subscription purchase matches the subscription ID. |