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.