Справочный центр Wialon

update_billing_plan

Для создания, обновления и удаления тарифного плана используйте метод update_billing_plan.

Copied!
svc=account/update_billing_plan&params={"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 Email адрес.

Флаги тарифного плана

Флаг Описание
0x01 Блокировать пользователей, если баланс ниже порога блокировки.
0x02 Если баланс ниже минимального, пользователь не может войти в систему, а учетная запись блокируется.
0x08 Запрещено использовать указанные типы оборудования.
0x10 Запрещено использовать типы оборудования, которые не указаны.
0x20 Уменьшать количество дней в счетчике дней и блокировать учетную запись, когда количество оставшихся дней достигает минимума.

Типы оборудования

Название Описание
<hw_name> Название оборудования.
id ID оборудования.

Услуги

Название Описание
cost Лимит и стоимость в формате, описанном на странице Услуги.
descr Описание услуги.
flags Определяет действие: 0 — нет, 1 — создать/обновить, 2 — удалить.
interval Частота сброса:
  • 0 — нет
  • 1 — ежечасно
  • 2 — ежедневно
  • 3 — еженедельно
  • 4 — ежемесячно
  • maxUsage Количество доступных элементов.
    name Название услуги.
    type Тип услуги: 1 — по требованию, 2 — периодическая.

    Более подробную информацию об услугах можно найти на странице get_account_data.

    Ответ

    Если запрос выполнен успешно, ответ имеет следующий вид:

    Copied!
    {
        "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.

    Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.

    Сообщить об ошибке

    Ваше сообщение отправлено. Спасибо!

    Произошла ошибка при отправке формы

    Скачать файл PDF
    Скачать документ Word

    Смотрите также