Группа методов Promo_Code внешнего программного интерфейса Менеджера сервиса предназначена для работы абонентов сервиса с промокодами.
Сводка по методам
Для выполнения всех методов этой группы пользователь, от имени которого вызывается программный интерфейс, должен обладать следующей ролью:
- Владелец абонента
Метод | Примечание |
---|---|
root | |
Выполняет активацию промокода | |
list | Получить список ранее активированных абонентом промокодов. |
promo_code/activate
Метод выполняет активацию указанного промокода для указанного абонента. Аналогов для этого метода в интерфейсе Личного кабинета нет.
Параметр | Тип | Примечание |
---|---|---|
Запрос | ||
account | Число | Код абонента |
code | Строка | Промо-код |
subid* | Строка | Дополнительная информация о промокоде |
Ответ (1) | ||
нет параметров |
При неудачной активации метод возвращает значение кода возврата (параметр ответа general.response):
- 10452, если промокод не найден или для него исчерпано количество активаций
- 10453, если промокод заблокирован
- 10454, если срок действия промокода истек
promo_code/list
Метод возвращает список ранее активированных абонентом промокодов. Аналогов для этого метода в интерфейсе Личного кабинета нет.
Параметр | Тип | Примечание |
---|---|---|
Запрос | ||
account | Число | Код абонента. |
Ответ code (0..) | ||
id | Строка | Промо-код |
activated | Дата и время | Момент активации промокода |
success | БУлево | Результат активации (успешно, или нет) |