Содержание

Сообщения

В данном разделе рассмотрены форматы всех типов сообщений системы Wialon. Сообщения определенного типа можно запросить используя флаги, их список представлен ниже:

Типы сообщений:

Флаг Описание
Сообщения объекта
0x0000 сообщение с данными
0x0100 SMS
0x0200 команда
0x0600 событие
Сообщения ресурса
0x0300 уведомление
0x0500 сообщение биллинга
0x0900 SMS для водителя
Журнал
0x1000 записи журнала

Для удаления определенных сообщений нужно иметь следующие ACL-флаги:

Что удалить Флаг сообщения ACL-флаг
Сообщения с данными 0x0000 0x800000
SMS-Сообщения 0x0100 0x800000
Отправленные команды 0x0200 0x800000
Зарегистрированные события 0x0600 0x2000000
Журнал 0x1000 0x800

:!: Смотрите более подробную информацию по ACL-флагам.

Сообщениe с данными

Флаг - 0x0000

{
	"t":<uint>,		/* время сообщения (UTC) */
	"f":<uint>,		/* флаги (см. таблицу ниже)*/
	"tp":"ud",		/* тип сообщения (ud - сообщение с данными) */
	"pos":{			/* местоположение */
		"y":<double>,		/* широта */
		"x":<double>,		/* долгота */
		"z":<int>,		/* высота над уровнем моря */
		"s":<uint>		/* скорость */
		"c":<uint>,		/* курс */
		"sc":<ubyte>		/* количество спутников */
	},
	"i":<uint>,		/* входящие данные */
	"o":<uint>,		/* исходящие данные */
	"p":{			/* параметры */
		<text>:<double>,
		...	
	}
}

Флаги сообщений с данными:

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

SMS сообщение

Флаг - 0x0100

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги: у SMS сообщений нет флагов, поэтому будет стоять 0 */
	"tp":"us",	/* тип сообщения (us - SMS сообщение) */
	"st":<text>,	/* текст сообщения */
	"mp":<text>,	/* телефонный номер модема */
	"p":{}		/* параметры */
}

Команда

Флаг - 0x0200

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги: у сообщений с командами нет флагов, поэтому будет стоять 0 */
	"tp":"ucr",	/* тип сообщения (ucr - команда) */
	"ca":<text>,	/* название команды */
	"cn":<text>,	/* тип команды */
	"cp":<text>,	/* параметры команды */
	"ui":<uint>,	/* ID пользователя */
	"ln":<text>,	/* название связи */
	"lt":<text>,	/* тип связи */
	"et":<uint>,	/* время выполнения */
	"p":{}		/* параметры */
}

Типы связи рассмотрены в разделе Команды: cоздание, редактирование и удаление.

Событие

Флаг - 0x0600

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги (см. таблицу ниже))*/
	"tp":"evt",	/* тип сообщения (evt - событие) */
	"et":<text>,	/* текст события */
	"x":<double>,	/* долгота */
	"y":<double>,	/* широта */
	"p":{}		/* параметры */
}

Флаги событий:

Значение Описание
0x0 простое событие
0x1 нарушение
0x2 событие техобслуживания
0x4 событие контроля маршрута
0x10 устанавливается дополнительно к флагу 0x2: зарегистрировано техобслуживание
0x20 устанавливается дополнительно к флагу 0x2: произошла заправка

Уведомление

Флаг - 0x0300

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги: у сообщений с уведомлениями нет флагов, поэтому будет стоять 0 */
	"tp":"xx",	/* тип сообщения */
	"p":{}		/* параметры */
}

Cообщение биллинга

Флаг - 0x0500

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги: 0x1 - устанавливается когда сообщение содержит запись о платеже */
	"tp":"xx",	/* тип сообщения */
	"p":{}		/* параметры */
}

SMS для водителя

Флаг - 0x0900

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":<uint>,	/* флаги: 0x1 - устанавливается когда сообщение отправлено */
	"tp":"xx",	/* тип сообщения */
	"p":{		/* параметры */
		"phone":<text>,		/* телефонный номер */
		"sms_text":<text>,	/* текст смс */
		"driver_name":<text>,	/* имя водителя */
		"driver_id":<uint>	/* ID водителя */
	}
}

Журнал

Флаг - 0x1000

{
	"t":<uint>,	/* время сообщения (UTC) */
	"f":4096,	/* флаги: 4096 - сообщения журнала */
	"tp":"xx",	/* тип сообщения */
	"p":{		/* параметры */
		"user":<text>,		/* имя пользователя */
		"action":<text>,	/* действие */
		"host":<text>,		/* хост */
		"p1":<text>,		/* параметры */
		...		
	}
}