update_billing_plan
Для создания, обновления и удаления тарифного плана используйте метод update_billing_plan.
svc=account/update_billing_plan¶ms={"callMode":<text>,
"plan":{
"name":<text>,
"rename":<text>,
"servicesModCounter":<uint>,
"historyPeriod":<**int**>,
"flags":<uint>,
"denyBalance":<**double**>,
"blockBalance":<**double**>,
"minDaysCounter":<**int**>,
"currencyFormat":<text>,
"descr":<text>,
"email":<text>,
"enable_smtp": <text>, /* Состояние SMTP email */
"smtp_host": <text>, /* SMTP-хост */
"smtp_port": <text>, /* SMTP-порт */
"smtp_login": <text>, /* SMTP-логин */
"smtp_password": <text>, /* SMTP-пароль */
"mapserver_tags":<text>, /* Теги карт */
"hwTypes":{
"<hw_id>":
{
"name": <uint>
},
...
},
"parent": <text>,
"personal":
{
"services": <object>
}
}
}
Параметры
Запрос должен содержать следующие параметры:
Параметр | Описание |
---|---|
callMode | Тип запроса (создание, обновление, удаление). |
name | Название тарифного плана (уникальное поле). |
rename | Новое название тарифного плана. Вы не можете редактировать название тарифного плана пользователя учетной записи верхнего уровня. Названия тарифных планов уникальны. Вы не можете дать одинаковое название двум тарифным планам. |
servicesModCounter | Количество изменений в списке услуг. |
historyPeriod | Время хранения сообщений объекта в днях. |
flags | Флаги тарифного плана (см. ниже). |
denyBalance | Минимальный баланс для активности учетной записи. Если баланс ниже, учетная запись блокируется. |
blockBalance | Минимальный баланс для доступности платных услуг. Если баланс ниже, услуги блокируются. |
minDaysCounter | Количество дней, оставшихся до блокировки учетной записи. Количество дней уменьшается, если включена опция Блокировка по дням. |
currencyFormat | Формат валюты. |
descr | Описание тарифного плана. |
Email адрес. |
Флаги тарифного плана
Флаг | Описание |
---|---|
0x01 | Блокировать пользователей, если баланс ниже порога блокировки. |
0x02 | Если баланс ниже минимального, пользователь не может войти в систему, а учетная запись блокируется. |
0x08 | Запрещено использовать указанные типы оборудования. |
0x10 | Запрещено использовать типы оборудования, которые не указаны. |
0x20 | Уменьшать количество дней в счетчике дней и блокировать учетную запись, когда количество оставшихся дней достигает минимума. |
Типы оборудования
Название | Описание |
---|---|
<hw_name> | Название оборудования. |
id | ID оборудования. |
Услуги
Название | Описание |
---|---|
cost | Лимит и стоимость в формате, описанном на странице Услуги. |
descr | Описание услуги. |
flags | Определяет действие: 0 — нет, 1 — создать/обновить, 2 — удалить. |
interval | Частота сброса: |
maxUsage | Количество доступных элементов. |
name | Название услуги. |
type | Тип услуги: 1 — по требованию, 2 — периодическая. |
Более подробную информацию об услугах можно найти на странице get_account_data.
Ответ
Если запрос выполнен успешно, ответ имеет следующий вид:
{
"parent":<text>, /* Название родительского тарифного плана. */
"name":<text>, /* Название тарифного плана. */
"servicesModCounter":<uint>, /* Количество изменений услуг.*/
"historyPeriod":<uint>, /* Период хранения сообщений в днях. Если указан 0, период не ограничен. */
"flags":<uint>, /* Флаги тарифного плана. */
"denyBalance":<int>, /* Значение баланса, при котором платные услуги становятся недоступными. */
"blockBalance":<int>, /* Значение баланса, при котором учетная запись блокируется. */
"minDaysCounter":<int>, /* Количество дней, оставшихся до блокировки учетной записи. */
"currencyFormat":<text>, /* Формат валюты. */
"descr":<text>, /* Описание. */
"email":<text>, /* Email. */
"mapserverTags":<text>, /* Теги сервера карт. */
"hwTypes":{ /* Объект оборудования. */
"<hw_id>": /* ID оборудования. */
{
"name": <text> /* Название оборудования. */
},
...
},
"personal":
{
"services": <object> /* Объект услуг (см. ниже). */
},
"combined":
{
"services":{ /* Объект услуг, где ключами являются корректные названия услуг. */
"<service_name>":{ /* Вместо <service_name> укажите название услуги. */
"type": <uint>, /* Тип: 1 — по требованию; 2 — периодическая. */
"maxUsage": <int>, /* Количество активных ресурсов услуги. */
"cost": <text>, /* Максимальное количество ресурсов. */
"interval": <uint>, /* Таблица стоимости. */
"descr": <text>, /* Интервал: 0 — нет, 1 — ежечасно, 2 — ежедневно, 3 — еженедельно, 4 — ежемесячно. */
"flags": <uint>
},
...
}
}
}
Для получения более подробной информации об услугах посетите страницу get_account_data.