Это старая версия документа.


Тарифный план: создание, редактирование, удаление.

Используйте данную команду для операций с тарифным планом:

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>,
					     "hwTypes":{		
							"<hw_id>":			
								     { 		
							     	        "name": <text>	
								     },
							...
					     },
					     "parent": <text>,
				             "personal":
				        	        {
	        			           	    "services": <object>
				        	        }
					}}

Параметры

Plan

Название Описание
callMode режим: create(создание), update(изменение), delete(удаление)
name имя тарифного плана (уникальное поле)
rename новое имя тарифного плана для переименования
servicesModCounter счетчик, показывающий сколько раз список сервисов был изменен
historyPeriod время хранения сообщений объектов, дней
flags флаги тарифного плана (см.ниже)
denyBalance величина баланса, ниже которого происходит блокировка
blockBalance величина баланса, ниже которого происходит блокировка операций
minDaysCounter минимальное число дней, ниже которого происходит блокировка
currencyFormat формат валюты
descr описание тарифного плана
email ящик электронной почты

:!: Уточнения для rename:
1. нельзя редактировать имя топового тарифного плана;
2. нельзя установить тарифному плану имя, уже имеющееся в системе.

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

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

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

Название Описание
id id оборудования
name имя оборудования

Сервисы

Название Описание
cost таблица стоимости
descr описание сервиса
flags определяет действие: 0 - нет, 1 - создать/редактировать, 2 - удалить
interval интервал: 0 - нет, 1 - ежечасно, 2 - ежедневно,
3 - еженедельно, 4 - ежемесячно
maxUsage количество доступных единиц
name имя сервиса
type тип: 1 - по требованию, 2 - периодический

Посетите эту страницу, чтобы узнать больше о сервисах.

Возвращаемый результат

{
	"parent":<text>,			/* имя родительского тарифного плана */
	"name":<text>,				/* имя тарифного плана */
	"servicesModCounter":<uint>,		/* счетчик изменений сервисов */
	"historyPeriod":<uint>,			/* время хранения сообщений от объектов (если 0 - неограничен)*/
	"flags":<uint>,				/* флаги */
	"denyBalance":<int>,			/* значение баланса, ниже которого наступает блокировка операций */
	"blockBalance":<int>,			//* значения баланса, ниже которого наступает блокировка */
	"minDaysCounter":<int>,			/* минимальное число дней, ниже которого наступает блокировка */
	"currencyFormat":<text>,		/* формат валюты */ 
	"descr":<text>,				/* описание тарифного плана */
	"email":<text>,				/* ящик электронной почты */
	"mapserverTags":<text>,			/* тэги сервера карт */
	"hwTypes":{				/* объект оборудования */
				"<hw_id>":			/* id оборудования */
					     { 		
				     	        "name": <text>			/* имя оборудования */
					     },
				...
		},
	"personal":
	        	        {
	        	        	"services": <object>	/* объект сервисов (см. ниже) */
	        	        },
	"combined":
	        	        {
	        	        	"services": <object>	/* объект сервисов (см. ниже) */
	        	        }
	}
}

Объект сервисов

"services":{                          /* объект сервисов, где ключи -- корректные имена сервисов */
                "<service_name>":{                  /* подставьте корректное имя сервиса вместо <service_name> */
                                "name": <text>,
                                "type": <uint>,
                                "maxUsage": <int>,
                                "cost": <text>,
                                "interval": <uint>,
                                "descr": <text>,
                                "flags": <uint>
                },
                ...
}

Обращайтесь сюда за списком сервисов.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2024 Gurtam