Формат запроса

Все запросы осуществляются только методом POST. Дополнительные параметры («params») должны быть представлены в формате JSON. Ответ так же возвращается в виде JSON. Все текстовые параметры, посланные и принятые, предполагают использование кодировки UTF-8.

Шаблон запроса:

http://{host}/wialon/ajax.html?sid=<sid>&svc=<svc>&params={<params>}

:!: Внимание! В заголовке запроса обязательно указывать Content-Type:application/x-www-form-urlencoded

Параметры

Название Описание
sid уникальный идентификатор сессии
svc название команды
params параметры для выполнения команды

:!: Внимание! В следующих разделах будут рассматриваться значения только двух параметров: svc и params. При выполнении всех запросов (кроме логина и некоторых запросов из раздела Другие запросы) идентификатор сессии (sid) является обязательным параметром.

Ограничения

Ограничения по логинам и сессиям:

  • Не более 10 неудачных попыток входа с одного IP-адреса за минуту;
  • Не более 120 успешных входов в систему с одного IP-адреса за минуту;
  • Не более 100 активных сессий одного пользователя с одного IP-адреса.

В случае нарушения этих ограничений наступает временная блокировка IP-адреса, что может привести к затруднениям при входе в систему.

Ограничения по сообщениям:

  • Не более 4 млн сообщений может быть выгружено во все сессии пользователя;
  • Не более 10 млн сообщений может быть выгружено в течение 2 минут одним пользователем;
  • Не более 500 тыс. сообщений может быть импортировано в течение 1 минуты.

По достижении лимита, сообщения перестают выгружаться и импортироваться. Это может привести к затруднениям при выполнении отчетов, построении треков и т.п. В этом случае очистите панели треков, сообщений и отчетов (либо перезагрузите страницу), а затем попробуйте снова.

Ограничения по отчетам:

  • На выполнение отчета онлайн отводится 2 минуты;
  • На выполнение отчета по заданию или уведомлению отводится 10 минут.

По достижении таймаута выполнение отчета будет принудительно прервано, т.е. отчет сгенерирован не будет. В этом случае следует уменьшить интервал отчета, количество объектов либо объем запрашиваемых данных (таблиц, графиков и т.п.).

Прочие ограничения:

  • В рамках одной сессии может одновременно обрабатываться не более 3 трудоемких запросов, таких как выгрузка сообщений, выполнение отчета и т.п;
  • В рамках одной сессии может одновременно обрабатываться не более 10 API-запросов;
  • В рамках одной сессии может одновременно производиться не более 3 трассировок карты;
  • Не более 10 запросов avl_evts может быть обработано в течение 10 секунд.
Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2024 Gurtam