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

Материал из TK
Версия от 19:21, 6 августа 2016; Admin (обсуждение | вклад) (Создание токена)
Перейти к: навигация, поиск

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

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

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

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

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

WebMap MakeTokenForm.png

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

/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/DeleteToken
Параметр Описание Требуется?
id ID токена Обязателен

Пример:

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