WebMap - Создание токенов

Через создание токенов можно предоставлять конечным пользователям уникальную ссылку для отслеживания транспортных средств в ограниченный период времени (например для слежения за грузами или доставкой).

Поддерживается следующие операции с токенами:

• Создание токена
• Изменение параметров токена (период действия, список доступных ТС, включение/отключение режима трека, ...)
• Удаление токена

Перед созданием токена необходима Аутентификация. Все операции выполняются методом POST с заголовком Content-Type = "application/x-www-form-urlencoded" и кодировке UTF-8.

Форма создания токена в WebMap:

Создание токена

/Account/MakeToken

Параметр	Описание	Требуется?
id	ID организации, в которой будет выполнятся поиск объектов нижеуказанных UIDов. Может быть как целочисленным идентификатором (таблица Orgs, поле ID), так и GUIDом организации (таблица Orgs, поле UID)	Обязателен
iduser	ID пользователя, на которого создается токен (таблица Users в БД)	Обязателен
objID	GUID объекта или объектов (ТС), на которой создаются токены. Один или несколько GUIDов (через запятую). Может быть как GUID группы так и отдельных ТС, так и тех и других (таблицы CarGroup и Cars в БД, поле UID)	Обязателен
objSubgroups	true, если включать в токен все подгруппы указанных в objID групп или false, если включатся только ТС в указанной группе.	Если отсутствует - принимается как false
objTrack	true, если показывать трек за текущие сутки (по умолчанию) по всем доступным токену ТС или false, если только последнее местоположение	Если отсутствует - принимается как false
geoFilterID	GUID геозон, которые используются для фильтрации. Позволяет ограничить просмотр трека - трек будет отображаться только в указанных геозонах, например если указана большая геозона очерченная вокруг города - трек ТС будет показываться только в городе и не будет показываться вне этой геозоны (таблица GeoObject или GeoObjectGroup, поле UID)	Не обязателен
geoFilterSubgroups	true, если при фильтрации используется все вложенные подгруппы, а geoFilterID - GUID группы	Если отсутствует - принимается как false
geoViewID	GUID геозон или групп геозон, которые будут показываться на карте	Не обязателен
geoViewSubgroups	true, если для отображения используется все вложенные подгруппы, а geoFilterID - GUID группы	Если отсутствует - принимается как false
SD	дата/время начала действия токена - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - токен начинает действовать немедленно
ED	дата/время окончания действия токена - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - токен будет бессрочным
VSD	начальные дата/время доступных токену данных по ТС, локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - данные доступны за весь период
VED	конечные дата/время доступных токену данных - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - данные доступны за весь период

Пример:

id=49&iduser=2&objID=25f86189-adc9-445d-940c-abf860874622&objSubgroups=true&objTrack=falseSD=20160806-0000&ED=20160901-0700

Результат (JSON)
Успех	{"ok":true,"data":"/Strict/Token/6aa9913c-4543-4d25-bb0f-e36d5082a89e", "id":"6aa9913c-4543-4d25-bb0f-e36d5082a89e"}
Ошибка	{"ok":false,"msg":"Отказано в доступе"}

Изменение параметров токена

/Account/ModifyToken

Параметр	Описание	Требуется?
id	ID токена (GUID)	Обязателен
objID	GUID объекта или объектов (ТС), на которой создаются токены. Один или несколько GUIDов (через запятую). Может быть как GUID группы так и отдельных ТС, так и тех и других (таблицы CarGroup и Cars в БД, поле UID)	Не обязателен
objSubgroups	true, если включать в токен все подгруппы указанных в objID групп или false, если включатся только ТС в указанной группе.	Если отсутствует - принимается как false
objTrack	true, если показывать трек за текущие сутки (по умолчанию) по всем доступным токену ТС или false, если только последнее местоположение	Если отсутствует - принимается как false
geoFilterID	GUID геозон, которые используются для фильтрации. Позволяет ограничить просмотр трека - трек будет отображаться только в указанных геозонах, например если указана большая геозона очерченная вокруг города - трек ТС будет показываться только в городе и не будет показываться вне этой геозоны (таблица GeoObject или GeoObjectGroup, поле UID)	Не обязателен
geoFilterSubgroups	true, если при фильтрации используется все вложенные подгруппы, а geoFilterID - GUID группы	Если отсутствует - принимается как false
geoViewID	GUID геозон или групп геозон, которые будут показываться на карте	Не обязателен
geoViewSubgroups	true, если для отображения используется все вложенные подгруппы, а geoFilterID - GUID группы	Если отсутствует - принимается как false
SD	дата/время начала действия токена - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - токен начинает действовать немедленно
ED	дата/время окончания действия токена - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - токен будет бессрочным
VSD	начальные дата/время доступных токену данных по ТС, локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - данные доступны за весь период
VED	конечные дата/время доступных токену данных - локальное время пользователя. Формат YYYYMMDD-HHMM	Не обязательный параметр, если отсутствует - данные доступны за весь период

Пример:

id=6aa9913c-4543-4d25-bb0f-e36d5082a89e&objID=25f86189-adc9-445d-940c-abf860874622&objSubgroups=true&objTrack=falseSD=20160806-0000&ED=20160901-0700

Результат (JSON)
Успех	{"ok":true,"data":"/Strict/Token/6aa9913c-4543-4d25-bb0f-e36d5082a89e", "id":"6aa9913c-4543-4d25-bb0f-e36d5082a89e"}
Ошибка	{"ok":false,"msg":"Отказано в доступе"}

Удаление токена

/Account/DeleteToken

Параметр	Описание	Требуется?
id	ID токена	Обязателен

Пример:

id=6aa9913c-4543-4d25-bb0f-e36d5082a89e

Результат (JSON)
Успех	{"ok":true}
Ошибка	{"ok":false,"msg":"Отказано в доступе"}