Содержание

Логин






Устаревший метод авторизации (см. token/login). Действовал до 1 октября 2015 года.

Для того, чтобы начать работу с Wialon, необходимо сначала выполнить вход. Для этого используется команда core/login:

svc=core/login&params={"user":<text>,
		       "password":<text>,
		       "operateAs":<text>}

:!: После входа создается сессия, в пределах которой могут быть выполнены различные запросы. Если в течении 5 минут сервер не получит ни одного запроса, то он оборвет сессию. Для того, что бы этого не случилось можно каждые 5 минут посылать запрос, например: requests/avl_evts.

:!: Использование данного запроса рассмотрено в примере Логин/логаут.

:!: Если на запрос возвращается error:7, попробуйте использовать http-кодирование специальных символов (через %) для полей user, password и operateAs. Можно воспользоваться любым сервисом http-кодирования (например этим).

Параметры

Название Описание
user имя пользователя
password пароль
operateAs имя пользователя, от имени которого вы хотите осуществить вход (необязательный параметр)

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

{
	"host":<text>,			/* хост */
	"eid":<text>,			/* ID сессии*/
	"au":<text>,			/* имя пользователя */
	"pi":<int>,			/* интервал пинга */
	"tm":<uint>,			/* текущее время (UTC) */
        "wsdk_version":<text>           /* версия sdk */
	"user":{			/* пользователь, от имени которого был осуществлен вход */
		"nm":<text>,			/* имя  */
		"cls":<uint>,			/* ID базового класса "user" */
		"id":<long>,			/* ID */
		"prp":{				/* произвольные свойства, например: */
			"dst":<text>,			/* летнее время */
			"language":<text>,		/* язык (двухбуквенный код) */
			"msakey":<text>,		/* ключ доступа к мобильной версии сайта */
			"pcal":<text>,			/* иранский календарь */
			"tz":<text>,			/* часовой пояс */
			"us_units":<text>,		/* единицы измерения США (мили и галлоны) */
			...				
		},
		"crt":<uint>,			/* ID создателя */
		"bact":<uint>,			/* ID учетной записи */
		"fl":<uint>,			/* флаги пользователя */
		"hm":<text>,			/* маска хоста */
		"uacl":<uint>			/* права пользователя на самого себя */
	},
	"classes":{			/* базовые классы доступные текущему пользователю: ключ - название базового класса, значение - ID базового класса */
		"avl_hw":<uint>,		/* тип оборудования */
		"avl_resource":<uint>,		/* ресурс */
		"avl_retranslator":<uint>,	/* ретранслятор */
		"avl_unit":<uint>,		/* объект */
		"avl_unit_group":<uint>,	/* группа объектов */
		"user":<uint>,			/* пользователь */
		"avl_route":<uint>		/* маршрут */
	},
	"features":{
		"unlim":<bool>,			/* тип тарифного плана: 0 - обычный, 1 - специальный для разработки и тестирования */
		"svcs": {			/* хэш-коллекция разрешенных сервисов, если сервис не указан - значит запрещён */
				"<service_name>":<bool>,	/* ключ - имя сервиса, значение: 0 - сервис разрешен, но достигнут лимит, 1 - сервис разрешен и им можно пользоваться */
				...
		}		
	}
}

:!: Уточненине для <service_name>: за дополнительной информацией по сервисам обращайтесь к списку сервисов.

Флаги пользователя рассмотрены в разделе Установить флаги настроек пользователя.

Возможные ошибки

Код Значение
6 Сервер недоступен

Так же возможны другие ошибки.