Для того, чтобы начать работу с Wialon, необходимо сначала выполнить вход. Для этого используется команда core/login:
svc=core/login¶ms={"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 | Сервер недоступен |
Так же возможны другие ошибки.