WebMap - Создание токенов — различия между версиями

Материал из TK
Перейти к: навигация, поиск
(Создание токена)
 
(не показано 6 промежуточных версий этого же участника)
Строка 23: Строка 23:
 
|-
 
|-
 
|id
 
|id
|ID организации, в которой будет выполнятся поиск объектов нижеуказанных UIDов.
+
|ID организации, в которой будет выполнятся поиск объектов нижеуказанных UIDов. Может быть как целочисленным идентификатором (таблица Orgs, поле ID), так и GUIDом организации (таблица Orgs, поле UID)
 
|Обязателен
 
|Обязателен
 
|-
 
|-
Строка 80: Строка 80:
 
id=49&iduser=2&objID=25f86189-adc9-445d-940c-abf860874622&objSubgroups=true&objTrack=falseSD=20160806-0000&ED=20160901-0700
 
id=49&iduser=2&objID=25f86189-adc9-445d-940c-abf860874622&objSubgroups=true&objTrack=falseSD=20160806-0000&ED=20160901-0700
 
</pre>
 
</pre>
  +
  +
{|border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
  +
|Результат (JSON)
  +
|
  +
|-
  +
|Успех
  +
|{"ok":true,"data":"/Strict/Token/6aa9913c-4543-4d25-bb0f-e36d5082a89e", "id":"6aa9913c-4543-4d25-bb0f-e36d5082a89e"}
  +
|-
  +
|Ошибка
  +
|{"ok":false,"msg":"Отказано в доступе"}
  +
|}
   
 
== Изменение параметров токена ==
 
== Изменение параметров токена ==
  +
  +
<pre>/Account/ModifyToken</pre>
  +
  +
{|border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
  +
|-
  +
| Параметр
  +
| Описание
  +
| Требуется?
  +
|-
  +
|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
  +
|Не обязательный параметр, если отсутствует - данные доступны за весь период
  +
|}
  +
  +
Пример:
  +
  +
<pre>
  +
id=6aa9913c-4543-4d25-bb0f-e36d5082a89e&objID=25f86189-adc9-445d-940c-abf860874622&objSubgroups=true&objTrack=falseSD=20160806-0000&ED=20160901-0700
  +
</pre>
  +
  +
{|border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
  +
|Результат (JSON)
  +
|
  +
|-
  +
|Успех
  +
|{"ok":true,"data":"/Strict/Token/6aa9913c-4543-4d25-bb0f-e36d5082a89e", "id":"6aa9913c-4543-4d25-bb0f-e36d5082a89e"}
  +
|-
  +
|Ошибка
  +
|{"ok":false,"msg":"Отказано в доступе"}
  +
|}
   
 
== Удаление токена ==
 
== Удаление токена ==
  +
  +
<pre>/Account/DeleteToken</pre>
  +
  +
{|border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
  +
|-
  +
| Параметр
  +
| Описание
  +
| Требуется?
  +
|-
  +
|id
  +
|ID токена
  +
|Обязателен
  +
|}
  +
  +
Пример:
  +
  +
<pre>id=6aa9913c-4543-4d25-bb0f-e36d5082a89e</pre>
  +
  +
{|border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
  +
|Результат (JSON)
  +
|
  +
|-
  +
|Успех
  +
|{"ok":true}
  +
|-
  +
|Ошибка
  +
|{"ok":false,"msg":"Отказано в доступе"}
  +
|}

Текущая версия на 19:46, 6 августа 2016

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

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

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

Перед созданием токена необходима Аутентификация. Все операции выполняются методом 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/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":"Отказано в доступе"}