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

Получение статуса подписки

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

подсказка

Если не знаете с чего начать, прочтите инструкцию в сценариях использования.

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

Для реальных подписок:

GET
https://public-api.rustore.ru/public/subscription/{subscriptionToken}/state
предупреждение

Для тестовых подписок используйте отдельный метод:

GET
https://public-api.rustore.ru/public/sandbox/subscription/{subscriptionToken}/state

Для работы с тестовыми платежами и подписками вам понадобится новый ключ, при создании которого нужно указать методы для тестирования.

АтрибутТипОписаниеОбязательностьРасположениеПример
Public-TokenstringJwe-токен авторизации в Public API Rustore.
Как получить токен авторизации.
ДаheaderN/A
subscriptionTokenstringКак получить токен подписки, см. документацию по SDK платежей.Даpath111.123

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

АтрибутТипОписаниеОбязательностьРасположениеПример
codestringКод ответа.ДаbodyОК;
ERROR;
BAD_REQUEST;
NOT_FOUND.
messagestringРасшифровка кода ответа.НетbodyJwe token is expired
body{}objectТело ответаНетbodyN/A
timestampstringВремя ответа.Даbody2023-08-02T10:11:04.655684723+03:00

body{}

АтрибутТипОписаниеОбязательностьРасположениеПример
is_activebooleanФлаг активности подписки. Вычисляется по статусу подписки:
true — подписка активна, в одном из периодов: PROMO, START, STANDARD, GRACE;
false — подписка неактивна: в HOLD-периоде или завершилась.
Даbody.bodytrue

Пример успешного ответа

{
"code": "OK",
"message": null,
"body":
{
"is_active": true
},
"timestamp": "2024-01-21T14:08:33.548812228+03:00"
}

Пример ответа с ошибкой

{
"code": "ERROR",
"message": "Jwe token is expired",
"body": null,
"timestamp": "2024-01-21T13:51:59.654427798+03:00"
}

Валидация запроса

При получении запроса проверяется токен авторизации, полученный методом получения токена авторизации:

  • владелец и/или приложение не должны быть заблокированы;
  • токен должен быть действительным;
  • подписка приобретена в приложении, владельцем которого является компания, получившая токен доступа к Public API.