Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/03/28 11:43
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -1,5 +1,5 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 -== Описание ГЛОНАССSoft Public API == 2 +== Описание ГЛОНАССSoft Public API 3.0 == 3 3 4 4 == == 5 5 ... ... @@ -10,7 +10,7 @@ 10 10 11 11 (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов). 12 12 13 -(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять X-Auth (токен авторизации, получаемый методом auth/login). 13 +(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__). 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 ... ... @@ -17,46 +17,44 @@ 17 17 18 18 (% class="box" style="text-align: center;" %) 19 19 ((( 20 -(% style="color:#000000; font-size:14pt" %)**Раздел Клиенты**20 +(% style="color:#000000; font-size:14pt" %)**Раздел Авторизация** 21 21 ))) 22 22 23 23 (% class="box infomessage" %) 24 24 ((( 25 -(% style="color:#000000" %)** Получение основных параметров клиента—**(% lang="en-US" %)**GET**(%%)**/(%lang="en-US" %)api/v3/agents(%%)**25 + (% style="color:#000000; line-height:100%" %)**Авторизация **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/auth/login** 26 26 ))) 27 27 28 -(% style="color:#000000" %) Метод позволяет получить о сновныепараметры клиентов: наименование,полноенаименование,тип, статусиидентификатор клиента-родителя.Методвозвращаетинформациюоклиентахс учетом настроекавторизованногопользователя,указанногов запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**):28 +(% style="color:#000000" %) Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль. 29 29 30 -(% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»; 31 - 32 -(% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах; 33 - 34 -(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «Доступ к партнёрским клиентам». 35 - 36 36 (% style="color:#000000" %)Метод запроса: **GET** 37 37 38 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/ag ents?parentId=>>url:https://hosting.glonasssoft.ru/api/v3/agents?parentId=]](% style="color:#000000" %)<parentId>32 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo>>url:https://hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo]] 39 39 40 -(% style="color:#000000" %) Параметр запроса:<parentId>- идентификаторклиента-родителя (опционально)34 +(% style="color:#000000" %)В случае успешного выполнения метода, поле «__**AuthId**__» содержит токен авторизации «__**X-Auth**__». 41 41 42 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 36 +(% lang="en-US" %) 37 +(% style="color:#000000" %)**Ответ:** 43 43 44 -(% style="color:#000000" %)Ответ: [ { «agentId»: «», //идентификатор клиента «parentId»: «», //идентификатор клиента-родителя «name»: «», //наименование клиента «fullName»: «», //полное наименование клиента «agentInfoType»: , //тип клиента1 «status»: //статус клиента }, … ] 39 +(% lang="en-US" %) 40 +(% style="color:#000000" %){ 45 45 46 -(% style="color:#000000" %)Примечание. Возможные значение параметра agentInfoType: (% lang="en-US" %)[(% style="color:#000000; font-family:Liberation Serif,serif; font-size:12pt; font-style:normal; font-variant:normal; font-weight:normal" %)0 – Клиент, 1 – Партнер, 2 – Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - договор(% style="color:#000000" %)] 42 +(% lang="en-US" %) 43 +(% style="color:#000000" %) "AuthId": "" , ~/~/ токен авторизации 44 + "User": "" , ~/~/ имя пользователя 47 47 46 +(% lang="en-US" %) 47 +} 48 48 49 -(% class="box" style="text-align: center;" %) 50 -((( 51 -(% style="color:#000000; font-size:14pt" %)**Раздел Авторизация** 52 -))) 49 +**Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. 53 53 51 + 54 54 (% class="box infomessage" %) 55 55 ((( 56 56 (% style="color:#000000; line-height:100%" %)**Проверка авторизации **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/auth/check** 57 57 ))) 58 58 59 -(% style="color:#000000" %) Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 57 +(% style="color:#000000" %) Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 60 60 61 61 (% style="color:#000000" %)Метод запроса: **GET** 62 62 ... ... @@ -68,117 +68,166 @@ 68 68 (% style="color:#000000" %)**Ответ: В случае если сессия активна HTTP ответ «200». В случае если сессия разорвана HTTP ответ «401».** 69 69 70 70 71 -(% class="box infomessage" %)69 +(% class="box" style="text-align: center;" %) 72 72 ((( 73 -(% style="color:#000000; line-height:100%" %)**Авторизация**(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/auth/login**71 +(% style="color:#000000; font-size:14pt" %)**Раздел Клиенты** 74 74 ))) 75 75 76 -(% style="color:#000000" %) Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль. 77 - 78 -(% style="color:#000000" %)Метод запроса: **GET** 79 - 80 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo>>url:https://hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo]] 81 - 82 -(% style="color:#000000" %)В случае успешного выполнения метода, поле «AuthId» содержит токен авторизации «X-Auth». 83 - 84 -(% lang="en-US" %) 85 -(% style="color:#000000" %)**Ответ: [ { «AuthId»: «», //токен авторизации «User»: «», // имя пользователя }, … ]** 86 - 87 -**Примечание: **Время жизни токена авторизации задается через настройки пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. 88 - 89 -(% class="box" lang="en-US" style="text-align: center;" %) 90 -((( 91 -(% style="color:#000000; font-size:14pt" %)**Раздел Устройства** 92 -))) 93 - 94 94 (% class="box infomessage" %) 95 95 ((( 96 -(% style="color:#000000 ; line-height:100%" %)**Получение списка типовустройств **(%style="color:#000000" %)**—**(% lang="en-US" %)**GET /api/v3/devices/types**76 +(% style="color:#000000" %)**Получение основных параметров клиента — **(% lang="en-US" %)**GET **(%%)**/(% lang="en-US" %)api/v3/agents(%%)** 97 97 ))) 98 98 99 -(% style="color:#000000" %) Метод позволяет получить спи соктипов устройств. Метод возвращает информацию отипахустройствсучетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**).79 +(% style="color:#000000" %) Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 100 100 81 +(% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»; 82 + 83 +(% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах; 84 + 85 +(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__». 86 + 101 101 (% style="color:#000000" %)Метод запроса: **GET** 102 102 103 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/ users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]]89 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents?parentId=>>url:https://hosting.glonasssoft.ru/api/v3/agents?parentId=]](% style="color:#000000" %)<parentId> 104 104 91 +(% style="color:#000000" %)Параметр запроса: <__**parentId**__> - идентификатор клиента-родителя (опционально) 92 + 105 105 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 106 106 107 -(% style="color:#000000" %)Ответ: [95 +(% style="color:#000000" %)Ответ: 108 108 109 -(% class="western" %) 110 -{{{ { 111 - "deviceTypeId" : "", // ID типа устройства 112 - "deviceTypeName" : "" // Название типа устройства 113 - },}}} 97 +(% style="color:#000000" %){ 98 + "agentId": "", ~/~/ идентификатор клиента 99 + "parentId": "", ~/~/ идентификатор клиента-родителя 100 + "name": "", ~/~/ наименование клиента 101 + "fullName": "", ~/~/ полное наименование клиента 102 + "agentInfoType": "", ~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 103 + "status": "", ~/~/ статус клиента 104 +} 114 114 115 -(% style="text-align:left" %) 116 -(% style="color:#000000" %)…** **] 117 117 118 - 119 119 (% class="box" style="text-align: center;" %) 120 120 ((( 121 -(% style="color:#000000; font-size:14pt" %)**Раздел Датчики**109 +(% style="color:#000000; font-size:14pt" %)**Раздел Пользователи** 122 122 ))) 123 123 124 -(% class="box infomessage" %)112 +(% class="box successmessage" %) 125 125 ((( 126 -(% style="color:#000000; line-height:100%" %)** Получениесписка типовдатчиков**(% style="color:#000000" %)**— **(% lang="en-US" %)**GETnsors/types**114 +(% style="color:#000000; line-height:100%" %)**Добавление пользователя — **(% lang="en-US" %)**POST /api/v3/users** 127 127 ))) 128 128 129 -(% style="color:#000000" %) Метод позволяет получитьсписок типовдатчиков. Методвозвращаетинформацию о типахдатчиков с учетом настроек авторизованногопользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**).117 +(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 130 130 131 -(% style="color:#000000" %)Метод запроса: ** GET**119 +(% style="color:#000000" %)Метод запроса: **POST** 132 132 133 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/se nsors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]]121 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users>>url:https://hosting.glonasssoft.ru/api/v3/users]] 134 134 135 -(% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации 123 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 136 136 137 -(% style="color:#000000" %) Ответ:[125 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 138 138 139 -(% class="western" style="margin-bottom:19px" %) 140 -{{{ {}}} 127 +(% style="color:#000000" %){ 128 + "lastName": "", ~/~/ фамилия 129 + "firstName": "", ~/~/ имя 130 + "position": "", ~/~/ должность 131 + "phone": "", ~/~/ телефон 132 + "organization": "", ~/~/ организация 133 + "login": "", ~/~/ логин 134 + "password": "", ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) 135 + "email": "", ~/~/ email 136 + "description": "", ~/~/ описание 137 + "isEnabled": "", ~/~/ признак включения 138 + "parentId": "", ~/~/ Guid родительского агента 139 + "leaderId": "", ~/~/ Guid руководителя (null - не задан) 140 + "sessionDuration": "", ~/~/ продолжительность сессии, в минутах (null - по умолчанию, 30 минут) 141 + "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 142 + "kind": "", ~/~/ тип аутентификации (None - выключена, Email - по email) 143 + "target": "" , ~/~/ в случае аутентификации по email - email-адрес 144 + "groups": "" , ~/~/ группы пользователя, названия групп 145 +} 141 141 142 -(% style="color:#000000" %)«id»: «», //ID типа датчика «name»: «», //Название 147 +(% style="text-align:left" %) 148 +(% style="color:#000000; font-weight:normal" %)Ответ: 143 143 144 -(% class="western" %) 145 -{{{ "description": "" // Описание 146 - },}}} 150 +(% style="text-align:left" %) 151 +(% style="color:#000000; font-weight:normal" %){ 147 147 148 148 (% style="text-align:left" %) 149 -(% style="color:#000000" %)… ] 154 +(% style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 155 + "lastName": "" , ~/~/ Фамилия , 156 + "firstName": "" , ~/~/ Имя 157 + "position": "" , ~/~/ Должность 158 + "phone": "" , ~/~/ Телефон 159 + "organization": "" , ~/~/ Организация 160 + "login": "" , ~/~/ Логин 161 + "password": "" , ~/~/ Пароль 162 + "email": "" , ~/~/ Email 163 + "description": "" , ~/~/ Описание 164 + "isEnabled": "" , ~/~/ Признак включения 165 + "parentId": "" , ~/~/ Guid родительского агента 166 + "sessionDuration": "" , ~/~/ Продолжительность сессии, в минутах 167 + "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 168 + "kind": "" , ~/~/ тип аутентификации 169 + "target": "" , ~/~/ в случае аутентификации по email - email-адрес 170 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 150 150 172 +(% style="text-align:left" %) 173 +(% style="color:#000000; font-weight:normal" %)} 151 151 152 -(% class="box" style="text-align: center;" %) 153 -((( 154 -(% style="color:#000000; font-size:14pt" %)**Раздел Пользователи** 155 -))) 156 156 157 157 (% class="box successmessage" %) 158 158 ((( 159 -(% style="color:#000000; line-height:100%" %)** Добавление пользователя— **(% lang="en-US" %)**POST /api/v3/users**178 +(% style="color:#000000; line-height:100%" %)**Получение списка пользователей — **(% lang="en-US" %)**POST /api/v3/users/find** 160 160 ))) 161 161 162 -(% style="color:#000000" %) Метод позволяет добавитьпользователя.Методпозволяетдобавитьпользователя,указанноговзапросе(обязательный параметрв заголовкахзапроса-токенвторизации**«X-Auth»**).181 +(% style="color:#000000" %) Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее. 163 163 183 +(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«__Просмотр пользователей__»**. 184 + 164 164 (% style="color:#000000" %)Метод запроса: **POST** 165 165 166 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users>>url:https://hosting.glonasssoft.ru/api/v3/users]] 187 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]] 167 167 168 -(% style="color:#000000" %) Взаголовкахзапроса:X-Auth:Токенавторизации189 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 169 169 170 -(% style="color:#000000" %)Параметры в теле запроса (JSON): { «lastName»: «», // фамилия «firstName»: «», // имя «position»: «», // должность «phone»: «», // телефон «organization»: «», // организация «login»: «», // логин «password»: «», // пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) «email»: «», // email «description»: «», // описание «isEnabled»: «», // признак включения «parentId»: «», // Guid родительского агента «leaderId»: «», // Guid руководителя (null - не задан) «sessionDuration»: «», // продолжительность сессии, в минутах (null - по умолчанию, 30 минут) «doubleAuth»: { // параметры двухфакторной аутентификации «kind»: «», // тип аутентификации (None - выключена, Email - по email) «target»: «« // в случае аутентификации по email - email-адрес }, »groups»: [ // группы пользователя «», //названия групп «», «» ] }191 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 171 171 172 -(% style="text-align:left" %) 173 -(% style="color:#000000; font-weight:normal" %)Ответ: { «id»: «», //ID пользователя «lastName»: «», //Фамилия , «firstName»: «», //Имя «position»: «», //Должность «phone»: «», //Телефон «organization»: «», //Организация «login»: «», //Логин «password»: «», //Пароль «email»: «», //Email «description»: «», //Описание «isEnabled»: «», //Признак включения «parentId»: «», //Guid родительского агента «sessionDuration»: «», //Продолжительность сессии, в минутах «doubleAuth»: { //параметры двухфакторной аутентификации «kind»: «», //тип аутентификации «target»: «» //в случае аутентификации по email - email-адрес }, «groups»: [ // группы пользователя «user» //названия групп ] } 193 +(% style="color:#000000" %){ 174 174 195 + "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 196 + "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 197 + "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 198 + "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 175 175 200 +(% style="color:#000000" %)} 201 + 202 +(% style="color:#000000" %)Ответ: 203 + 204 +(% style="color:#000000" %){ (%%) 205 + 206 + "id": "" , ~/~/ идентификатор пользователя 207 + "lastName": "" , ~/~/ фамилия 208 + "firstName": "" , ~/~/ имя 209 + "position": "" , ~/~/ должность 210 + "phone": "" , ~/~/ телефон 211 + "parentId": "" , ~/~/ идентификатор клиента-родителя 212 + "parentName": "" , ~/~/ наименование клиента-родителя 213 + "organization": "" , ~/~/ организация 214 + "login": "" , ~/~/ логин 215 + "email": "" , ~/~/ E-mail 216 + "sessionDuration":"", ~/~/ длительность сессии в минутах 217 + "status": "1", ~/~/ статус пользователя 218 + "astLogged": "", ~/~/ дата/время последней авторизации 219 + 220 +(% style="color:#000000" %)} 221 + 222 + 176 176 (% class="box warningmessage" %) 177 177 ((( 178 178 (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users** 179 179 ))) 180 180 181 -(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 228 +(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 182 182 183 183 (% style="color:#000000" %)Метод запроса: **PUT** 184 184 ... ... @@ -187,62 +187,90 @@ 187 187 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 188 188 189 189 (% lang="en-US" style="text-align:left" %) 190 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): { «id»: «», // ID пользователя «lastName»: «», // фамилия «firstName»: «», // имя «position»: «», // должность «phone»: «», // телефон «organization»: «», // организация «login»: «», // логин «password»: «», // пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) «email»: «», // email «description»: «», // описание «isEnabled»: «», // признак включения «parentId»: «», // Guid родительского агента «leaderId»: «», // Guid руководителя (null - не задан) «sessionDuration»: «», // продолжительность сессии, в минутах (null - по умолчанию, 30 минут) «doubleAuth»: { // параметры двухфакторной аутентификации «kind»: «», // тип аутентификации (None - выключена, Email - по email) «target»: «« // в случае аутентификации по email - email-адрес }, »groups»: [ // группы пользователя «», //названия групп «», «» ] } Ответ: { «id»: «», //ID пользователя «lastName»: «», //Фамилия , «firstName»: «», //Имя «position»: «», //Должность «phone»: «», //Телефон «organization»: «», //Организация «login»: «», //Логин «password»: «», //Пароль «email»: «», //Email «description»: «», //Описание «isEnabled»: «», //Признак включения «parentId»: «», //Guid родительского агента «sessionDuration»: «», //Продолжительность сессии, в минутах «doubleAuth»: { //параметры двухфакторной аутентификации «kind»: «», //тип аутентификации «target»: «» //в случае аутентификации по email - email-адрес }, «groups»: [ // группы пользователя «user» //названия групп ] } //237 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 191 191 239 +(% lang="en-US" style="text-align:left" %) 240 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 192 192 193 -(% class="box warningmessage" %) 194 -((( 195 -(% style="color:#000000" %)**Изменить статус пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 196 -))) 242 +(% lang="en-US" style="text-align:left" %) 243 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 244 + "lastName": "" , ~/~/ фамилия 245 + "firstName": "" , ~/~/ имя 246 + "position": "" , ~/~/ должность 247 + "phone": "" , ~/~/ телефон 248 + "organization": "" , ~/~/ организация 249 + "login": "" , ~/~/ логин 250 + "password": "" , ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) 251 + "email": "" , ~/~/ email 252 + "description": "" , ~/~/ описание 253 + "isEnabled": "" , ~/~/ признак включения 254 + "parentId": "" , ~/~/ Guid родительского агента 255 + "leaderId": "" , ~/~/ Guid руководителя (null - не задан) 256 + "sessionDuration": "" , ~/~/ продолжительность сессии, в минутах (null - по умолчанию, 30 минут) 257 + "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 258 + "kind": "" , ~/~/ тип аутентификации 259 + "target": "" , ~/~/ в случае аутентификации по email - email-адрес 260 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 197 197 198 -(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 262 +(% lang="en-US" style="text-align:left" %) 263 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 199 199 200 -(% style="color:#000000" %)Метод запроса: **PUT** 265 +(% lang="en-US" style="text-align:left" %) 266 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 201 201 202 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/status/>>url:https://hosting.glonasssoft.ru/api/v3/users/status/]](% style="color:#000000" %){id} Параметр запроса: 268 +(% lang="en-US" style="text-align:left" %) 269 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 203 203 204 -(% style="color:#000000" %){id} - Guid пользователя В заголовках запроса: X-Auth: Токен авторизации Параметры в теле запроса (JSON): { «status»~:// «», //статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 271 +(% lang="en-US" style="text-align:left" %) 272 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя 273 + "lastName": "" , ~/~/ фамилия 274 + "firstName": "" , ~/~/ имя 275 + "position": "" , ~/~/ должность 276 + "phone": "" , ~/~/ телефон 277 + "organization": "" , ~/~/ организация 278 + "login": "" , ~/~/ логин 279 + "password": "" , ~/~/ пароль 280 + "email": "" , ~/~/ email 281 + "description": "" , ~/~/ описание 282 + "isEnabled": "" , ~/~/ признак включения 283 + "parentId": "" , ~/~/ Guid родительского агента 284 + "sessionDuration": "" , ~/~/ продолжительность сессии, в минутах 285 + "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 286 + "kind": "" , ~/~/ тип аутентификации 287 + "target": "" , ~/~/ в случае аутентификации по email - email-адрес 288 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 205 205 206 -(% class="western" %) 207 -{{{ "description": "", // описание 208 - "data": "" // данные, связанные со сменой статуса}}} 290 +(% lang="en-US" style="text-align:left" %) 291 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 209 209 210 -(% style="color:#000000" %)} 211 211 212 -(% style="text-align:left" %) 213 -(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** 214 - 215 - 216 -(% class="box successmessage" %) 294 +(% class="box warningmessage" %) 217 217 ((( 218 -(% style="color:#000000 ; line-height:100%" %)**Получение списка пользователей— **(% lang="en-US" %)**POST /api/v3/users/find**296 +(% style="color:#000000" %)**Изменение статуса пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 219 219 ))) 220 220 221 -(% style="color:#000000" %) Метод позволяет получитьосновные параметрыпользователей:логин,имя,адресэлектроннойпочты,номертелефона,статус,идентификаторклиента-родителяипрочее.299 +(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 222 222 223 -(% style="color:#000000" %)Метод возвращает информацию опользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляетсяпри наличии права**«Просмотр пользователей»**.301 +(% style="color:#000000" %)Метод запроса: **PUT** 224 224 225 -(% style="color:#000000" %) Методзапроса:**POST**303 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/status/>>url:https://hosting.glonasssoft.ru/api/v3/users/status/]](% style="color:#000000" %){id} 226 226 227 -(% style="color:#000000" %) URLзапроса:(%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]]305 +(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid пользователя 228 228 229 -(% style="color:#000000" %) Условияфильтрацииобъектовзадаютсяв телезапроса.Параметрывелезапроса (JSON): {307 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 230 230 231 -(% class="western" %) 232 -{{{ //"parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", // GUID агента, для которого надо получить данные, null - для текущего агента 233 - //"userId": "11111111-c384-43f8-8562-1c3d79a32303", // ID пользователя, по которому фильтруется, null - неважно 234 - "login": "qqqqqq", // Логин пользователя, по которому фильтруется, null - неважно 235 - //"email": "eee" // Email пользователя, по которому фильтруется, null - неважно}}} 309 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 236 236 237 -(% style="color:#000000" %) }311 +(% style="color:#000000" %){ 238 238 239 -(% style="color:#000000" %)Ответ: [ { «id»: «», //идентификатор пользователя «lastName»: «», //фамилия «firstName»: «», //имя «position»: «», //должность «phone»: «», //телефон «parentId»: «», //идентификатор клиента-родителя «parentName»: «», //наименование клиента-родителя «organization»: «», //организация «login»: «», //логин «email»: «», //E-mail 313 + "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 314 + "description": "" , ~/~/ описание 315 + "data": "" , ~/~/ данные, связанные со сменой статуса 240 240 241 -(% class="western" style="margin-bottom:19px" %) 242 -{{{ "sessionDuration":"", // длительность сессии в минутах}}} 317 +(% style="color:#000000" %)} 243 243 244 -(% lang="en-US"style="text-align:left" %)245 -(% style="color:#000000" %) «status»:1, //статусльзователя«lastLogged»: «» //дата/время последнейавторизации}, … ]**319 +(% style="text-align:left" %) 320 +(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** 246 246 247 247 248 248 (% class="box errormessage" %) ... ... @@ -250,14 +250,16 @@ 250 250 (% style="color:#000000; line-height:100%" %)**Удаление пользователя — **(% lang="en-US" %)**DELETE /api/v3/users/{id}** 251 251 ))) 252 252 253 -(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 328 +(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 254 254 255 255 (% style="color:#000000" %)Метод запроса: **DELETE** 256 256 257 257 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/>>url:https://hosting.glonasssoft.ru/api/v3/users/]](% style="color:#000000" %){id} 258 258 259 -(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя В заголовках запроса: X-Auth: Токен авторизации334 +(% style="color:#000000" %)Параметр запроса: {**__id__**} - Guid пользователя 260 260 336 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 337 + 261 261 (% style="text-align:left" %) 262 262 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 263 263 ... ... @@ -267,25 +267,6 @@ 267 267 (% style="color:#000000; font-size:14pt" %)**Раздел Транспортные средства** 268 268 ))) 269 269 270 -(% class="box errormessage" %) 271 -((( 272 -(% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 273 -))) 274 - 275 -(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 276 - 277 -(% style="color:#000000" %)Метод запроса: **DELETE** 278 - 279 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){vehicleId} 280 - 281 -(% style="color:#000000" %)Параметр запроса: {id} - Guid объекта 282 - 283 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 284 - 285 -(% style="text-align:left" %) 286 -(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 287 - 288 - 289 289 (% class="box infomessage" %) 290 290 ((( 291 291 (% style="color:#000000; line-height:100%" %)**Получение информации об объекте — **(% lang="en-US" %)**GET /api/v3/vehicles/{vehicleId}** ... ... @@ -293,17 +293,17 @@ 293 293 294 294 (% style="color:#000000" %) Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение». 295 295 296 -(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 354 +(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 297 297 298 298 (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов; 299 299 300 -(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«Просмотр заданий на техобслуживание»**. 358 +(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«__Просмотр заданий на техобслуживание__»**. 301 301 302 302 (% style="color:#000000" %)Метод запроса: **GET** 303 303 304 304 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %)<(% lang="en-US" %)v(%%)ehicleID> 305 305 306 -(% style="color:#000000" %)Параметр запроса: <vehicleid> - идентификатор объекта (опционально) 364 +(% style="color:#000000" %)Параметр запроса: <__**vehicleid**__> - идентификатор объекта (опционально) 307 307 308 308 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 309 309 ... ... @@ -311,24 +311,20 @@ 311 311 312 312 (% style="color:#000000" %){ 313 313 314 -(% class="western" %) 315 -{{{ "vehicleId": “”, // идентификатор объекта 316 - "name": "", // имя объекта 317 - "imei": "", // IMEI объекта 318 - "deviceTypeId": “”, // идентификатор устройства объекта 319 - "deviceTypeName": "" // наименование устройства объекта 320 - "parentId": "", // идентификатор клиента-родителя 321 - "parentName": "" // наименование клиента-родителя, 322 - "modelId": "", // идентификатор модели объекта 323 - "modelName": "" // наименование модели объекта, 324 - "unitId": "", // идентификатор подразделения 325 - "unitName": "", // наименование подразделения 326 - "status": “”, // статус объекта 327 - ... 328 - }, 329 - ...}}} 372 + "vehicleId": "" , ~/~/ идентификатор объекта 373 + "name": "" , ~/~/ имя объекта 374 + "imei": "" , ~/~/ IMEI объекта 375 + "deviceTypeId": "" , ~/~/ идентификатор устройства объекта 376 + "deviceTypeName": "" , ~/~/ наименование устройства объекта 377 + "parentId": "" , ~/~/ идентификатор клиента-родителя 378 + "parentName": "" , ~/~/ наименование клиента-родителя, 379 + "modelId": "" , ~/~/ идентификатор модели объекта 380 + "modelName": "" , ~/~/ наименование модели объекта, 381 + "unitId": "" , ~/~/ идентификатор подразделения 382 + "unitName": "" , ~/~/ наименование подразделения 383 + "status": "" , ~/~/ статус объекта 330 330 331 - (% style="color:#000000" %)}385 +} 332 332 333 333 (% style="text-align:left" %) 334 334 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: ... ... @@ -342,7 +342,7 @@ 342 342 (% style="color:#000000; line-height:100%" %)**Добавление объекта — **(% lang="en-US" %)**POST /api/v3/vehicles** 343 343 ))) 344 344 345 -(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**, //Content-Type//: **application/json**; //charset//=**utf-8**). 399 +(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__). 346 346 347 347 (% style="color:#000000" %)Метод запроса: **POST** 348 348 ... ... @@ -350,235 +350,399 @@ 350 350 351 351 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 352 352 353 -(% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON {407 +(% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 354 354 355 -(% class="western" %) 356 -{{{ "parentId": "", // ID клиента 357 - "name": "", // имя ТС 358 - "imei": "", // IMEI 359 - "deviceTypeId": "",// ID типа устройства 360 - "modelId": "", 361 - "unitId": "", // ID подразделения 362 - "sim1": "", // Номер SIM 1 363 - "sim2": "", // Номер SIM2 364 - "consumptionPer100Km" : "", // Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) 365 - "consumptionPerHour": "", // Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено) 366 - "consumptionIdle": "",// Расход топлива на холостом ходу 367 - "counters": { 368 - "mileage": "", // пробег 369 - "mileageEnabled": true, // флаг активности счётчика "пробег" 370 - "motohours":"", // моточасы 371 - "motohoursEnabled": true // флаг активности счётчика "моточасы" 372 - }, 373 - "cmsv6Parameters": { // параметры CMSv6 374 - "enabled": true, // флаг включения 375 - //"id": "", // идентификатор 376 - "host": "", // IP-адрес или доменное имя из URL веб-сайта CMSV6 377 - "login": "", // имя учетной записи 378 - "password": "" // пароль учетной записи 409 +(% style="color:#000000" %){ 410 + 411 + "parentId": "" , ~/~/ ID клиента 412 + "name": "" , ~/~/ имя ТС 413 + "imei": "" , ~/~/ IMEI 414 + "deviceTypeId": "" , ~/~/ ID типа устройства 415 + "modelId": "" , ~/~/ ID модели 416 + "unitId": "" , ~/~/ ID подразделения 417 + "sim1": "" , ~/~/ Номер SIM 1 418 + "sim2": "" , ~/~/ Номер SIM2 419 + "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) 420 + "consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено) 421 + "consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу 422 + "counters": { 423 + "mileage": "" , ~/~/ пробег 424 + "mileageEnabled": true, ~/~/ флаг активности счётчика "пробег" 425 + "motohours": "" , ~/~/ моточасы 426 + "motohoursEnabled": true ~/~/ флаг активности счётчика "моточасы" 379 379 }, 380 - "inspectionTasks": [ // задания на ТО 381 - { 382 - "enabled": "", // Признак включения 383 - "name": "", // Имя задания 384 - "description": "", // Описание задания 385 - "mileageCondition": "", // Условие по пробегу (в метрах, null - условие не работает) 386 - "lastMileage": "", // Пробег (в метрах) на момент последнего ТО (null - неважно) 387 - "motohoursCondition": "", // Условие по моточасам (в секундах, null - условие не работает) 388 - "lastMotohours": "", // Моточасы (в секундах) на момент последнего ТО (null - неважно) 389 - "periodicCondition": "", // Условие периодичности по времени (null - условие не работает) 390 - "kind": "", // Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает) 391 - "lastInspectionDate": "", // Дата последнего ТО (null - не указано) 392 - "maxQuantity": "" // Сколько раз выполнить задание (null - однократно) 428 + "cmsv6Parameters": { ~/~/ параметры CMSv6 429 + "enabled": true, ~/~/ флаг включения 430 + "id": "" , ~/~/ идентификатор 431 + "host": "" , ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 432 + "login": "" , ~/~/ имя учетной записи 433 + "password": "" ~/~/ пароль учетной записи 393 393 }, 394 - ]}}} 435 + "inspectionTasks": ~/~/ задания на ТО 436 + { 437 + "enabled": "" , ~/~/ Признак включения 438 + "name": "" , ~/~/ Имя задания 439 + "description": "" , ~/~/ Описание задания 440 + "mileageCondition": "" , ~/~/ Условие по пробегу (в метрах, null - условие не работает) 441 + "lastMileage": "" , ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно) 442 + "motohoursCondition": "" , ~/~/ Условие по моточасам (в секундах, null - условие не работает) 443 + "lastMotohours": "" , ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно) 444 + "periodicCondition": "" , ~/~/ Условие периодичности по времени (null - условие не работает) 445 + "kind": "" , ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает) 446 + "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 447 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 448 + } 395 395 396 -(% style="color:#000000" %) …}450 +(% style="color:#000000" %) } 397 397 398 398 (% style="color:#000000" %)Ответ: 399 399 400 400 (% style="color:#000000" %){ 401 401 402 -(% class="western" %) 403 -{{{ "vehicleId": "", //ID ТС 404 - "parentId": "", //Guid владельца ТС 405 - "name": "", //Имя объекта 406 - "imei": "", //IMEI 407 - "deviceTypeId": "", //ID типа устройства 408 - "modelId": "", //ID модели 409 - "unitId": "", //ID подразделения 410 - "sim1": "", //SIM1 411 - "sim2": "", //SIM2 412 - "consumptionPer100Km": "", //Расход топлива на 100 км 413 - "consumptionIdle": "", //Расход топлива на холостом ходу 414 - "counters": { //Счётчики 415 - "mileageEnabled": true, 416 - "motohoursEnabled": true, 417 - "mileage": "", 418 - "motohours": 345.0 419 - }, 420 - "cmsv6Parameters": { //Параметры CmsV6 421 - "id": null, 422 - "enabled": true, //флаг включения 423 - "host": "", // IP-адрес или доменное имя из URL веб-сайта CMSV6 424 - "login": "", // имя учетной записи 425 - "password": "" // пароль учетной записи 426 - }, 427 - "inspectionTasks": [ // задания на ТО 428 - { 429 - "id": "", // ID задачи 430 - "enabled": false, // Признак включения 431 - "name": "", // Имя задания 432 - "description": "", // Описание задания 433 - "mileageCondition": "", // Условие по пробегу 434 - "lastMileage": "", // Пробег (в метрах) 435 - "motohoursCondition": "", // Условие по моточасам 436 - "lastMotohours": "", // Моточасы 437 - "periodicCondition": "", // Условие периодичности по времени 438 - "kind": "", // Вид периодичности по времени 439 - "maxQuantity": "" // Сколько раз выполнить задание (null - однократно) 440 - } 441 - ]}}} 456 + "vehicleId": "", ~/~/ID ТС 457 + "parentId": "", ~/~/Guid владельца ТС 458 + "name": "", ~/~/Имя объекта 459 + "imei": "", ~/~/IMEI 460 + "deviceTypeId": "", ~/~/ID типа устройства 461 + "modelId": "", ~/~/ID модели 462 + "unitId": "", ~/~/ID подразделения 463 + "sim1": "", ~/~/SIM1 464 + "sim2": "", ~/~/SIM2 465 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 466 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 467 + "counters": { ~/~/Счётчики 468 + "mileageEnabled": true, 469 + "motohoursEnabled": true, 470 + "mileage": "", 471 + "motohours": 345.0 472 + }, 473 + "cmsv6Parameters": { ~/~/Параметры CmsV6 474 + "id": null, 475 + "enabled": true, ~/~/флаг включения 476 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 477 + "login": "", ~/~/ имя учетной записи 478 + "password": "" ~/~/ пароль учетной записи 479 + }, 480 + "inspectionTasks": { ~/~/ задания на ТО 481 + "id": "", ~/~/ ID задачи 482 + "enabled": false, ~/~/ Признак включения 483 + "name": "", ~/~/ Имя задания 484 + "description": "", ~/~/ Описание задания 485 + "mileageCondition": "", ~/~/ Условие по пробегу 486 + "lastMileage": "", ~/~/ Пробег (в метрах) 487 + "motohoursCondition": "", ~/~/ Условие по моточасам 488 + "lastMotohours": "", ~/~/ Моточасы 489 + "periodicCondition": "", ~/~/ Условие периодичности по времени 490 + "kind": "", ~/~/ Вид периодичности по времени 491 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 492 + } 442 442 443 443 (% style="text-align:left" %) 444 444 (% style="color:#000000" %)} 445 445 446 446 447 -(% class="box warningmessage" %)498 +(% class="box successmessage" %) 448 448 ((( 449 -(% style="color:#000000; line-height:100%" %)** Редактированиеобъекта— **(% lang="en-US" %)**PUT /api/v3/vehicles**500 +(% style="color:#000000; line-height:100%" %)**Получение параметров объектов — **(% lang="en-US" %)**POST /api/v3/vehicles/find** 450 450 ))) 451 451 452 -(% style="color:#000000" %) Метод позволяет от редактироватьобъект.Метод позволяетотредактировать объект,указанный в запросе(обязательныйпараметрвзаголовкахзапроса- токенавторизации **«X-Auth»**).503 +(% style="color:#000000" %) Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 453 453 454 -(% style="color:#000000" %)Метод запроса :**PUT**505 +(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 455 455 456 -(% style="color:#000000" %) URLзапроса:(%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles>>url:https://hosting.glonasssoft.ru/api/v3/vehicles]]507 +(% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов; 457 457 458 -(% style="color:#000000" %) Взаголовках запроса:X-Auth:Токен авторизации509 +(% style="color:#000000" %)− возвращает информацию об объектах с учетом заданных настроек видимости объектов; 459 459 511 +(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав **«__Видимость объектов заблокированных договоров в панели управления__»** или **«__Видимость объектов заблокированных договоров в мониторинге__»**; 512 + 513 +(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права **«__Просмотр номеров телефонов объектов__»**; 514 + 515 +(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права **«__Просмотр статуса объекта__»**. 516 + 517 +(% style="color:#000000" %)Метод запроса: **POST** 518 + 519 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/find>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/find]] 520 + 521 +(% style="color:#000000" %)В заголовках запроса: 522 + 523 +(% style="color:#000000" %)− Content-Type: __**application/json**__ 524 + 525 +(% style="color:#000000" %)− X-Auth: Токен авторизации 526 + 527 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 528 + 460 460 (% style="color:#000000" %)Параметры в теле запроса (JSON): 461 461 462 -(% style="color:#000000" %) //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON{«vehicleId»: «», //ID ТС «parentId»: «», //ID клиента «name»: «», //имя ТС «imei»: «», //IMEI «deviceTypeId»: «», //ID типа устройства «modelId»: «», «unitId»: «», //ID подразделения «sim1»: «», //SIM 1 «sim2»: «», //SIM2 «consumptionPer100Km»: «», //Расход топлива на 100 км «consumptionIdle»: «», //Расход топлива на холостом ходу «counters»: { «mileageEnabled»: true, //флаг активности счётчика «пробег» «motohoursEnabled»: true, //флаг активности счётчика «моточасы» «mileage»: «», //пробег «motohours»: «» //моточасы }, «cmsv6Parameters»: { //параметры CMSv6 «id»: «», //идентификатор «enabled»: true, //флаг включения «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6 «login»: «», //имя учетной записи «password»: «» //пароль учетной записи }, «inspectionTasks»: [ //задания на ТО { «id»: «», //ID задания «enabled»: false, //Признак включения «name»: «», //Имя задания «description»: «», //Описание задания «mileageCondition»: «», //Условие по пробегу (в метрах, null - условие не работает) «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО (null - неважно) «motohoursCondition»: «», //Условие по моточасам (в секундах, null - условие не работает) «lastMotohours»: «», //Моточасы (в секундах) на момент последнего ТО (null - неважно) «periodicCondition»: «», //Условие периодичности по времени (null - условие не работает) «kind»: «», //Вид периодичности по времени «maxQuantity»: «» //Сколько раз выполнить задание } ] }531 +(% class="western" style="color:#000000" %)##{## 463 463 533 +(% class="western" style="color:#000000" %)## "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) 534 + "name": null, ~/~/ Имя ТС (string, опционально) 535 + "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 536 + "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 537 + "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 538 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 539 + "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%) 540 +(% style="color:#000000" %)} 541 + 542 +(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 543 + 464 464 (% style="color:#000000" %)Ответ: 465 465 466 -(% lang="en-US" style="text-align:left" %) 467 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ «vehicleId»: «», //ID ТС «parentId»: «», //ID клиента «name»: «», //имя ТС «imei»: «», //IMEI «deviceTypeId»: «», //ID типа устройства «modelId»: «», «unitId»: «», //ID подразделения «sim1»: «», //SIM 1 «sim2»: «», //SIM2 «consumptionPer100Km»: «», //Расход топлива на 100 км «consumptionIdle»: «», //Расход топлива на холостом ходу «counters»: { «mileageEnabled»: true, //флаг активности счётчика «пробег» «motohoursEnabled»: true, //флаг активности счётчика «моточасы» «mileage»: «», //пробег «motohours»: «» //моточасы }, «cmsv6Parameters»: { //параметры CMSv6 «id»: «», //идентификатор «enabled»: true, //флаг включения «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6 «login»: «», //имя учетной записи «password»: «» //пароль учетной записи }, «inspectionTasks»: [ //задания на ТО { «id»: «», //ID задания «enabled»: false, //Признак включения «name»: «», //Имя задания «description»: «», //Описание задания «mileageCondition»: «», //Условие по пробегу «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО «motohoursCondition»: «», //Условие по моточасам «lastMotohours»: «», //Моточасы «periodicCondition»: «», //Условие периодичности по времени «kind»: «», //Вид периодичности по времени «maxQuantity»: «» //Сколько раз выполнить задание } ] } 546 +(% style="color:#000000" %){ 468 468 548 +(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 549 + "name": "" ~/~/ наименование объекта 550 + "imei": "" ~/~/ IMEI объекта 551 + "deviceTypeId": "" ~/~/ идентификатор типа устройства 552 + "deviceTypeName": "" ~/~/ наименование типа устройства 553 + "sim1": "" ~/~/ первый номер телефона 554 + "sim2": "" ~/~/ второй номер телефона 555 + "parentId": "" ~/~/ идентификатор клиента-родителя 556 + "parentName": "" ~/~/ наименование клиента-родителя 557 + "modelId": "" ~/~/ идентификатор модели объекта 558 + "modelName": "" ~/~/ наименование модели объекта 559 + "unitId": "" ~/~/ идентификатор подразделения 560 + "unitName": "" ~/~/ наименование подразделения 561 + "status": "" ~/~/ статус объекта (%%)(-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 562 + ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 563 + ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 564 +(% style="color:#000000" %) "createdAt": "" ~/~/ дата создания объектов (%%) 565 +(% style="color:#000000" %)} 469 469 567 +(% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 568 + 569 + 470 470 (% class="box successmessage" %) 471 471 ((( 472 -(% style="color:#000000; line-height:100%" %)** Получение списка объектов— **(% lang="en-US" %)**POST /api/v3/vehicles**572 +(% style="color:#000000; line-height:100%" %)**Изменение статуса объекта — **(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}** 473 473 ))) 474 474 475 -(% style="color:#000000" %) Метод позволяет получитьосновные параметрыобъектов:наименование, IMEI,типустройства,модель объекта,подразделение,номера телефонови идентификаторклиента,ккоторомуприкрепленобъект (клиент-родитель).575 +(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 476 476 477 -(% style="color:#000000" %) возвращает информацию об объектах с учетом настроек авторизованногопользователя, указанного в запросе (обязательныйпараметр в заголовках запроса - токен авторизации**«X-Auth»**):577 +(% style="color:#000000" %)Метод запроса: **POST** 478 478 479 -(% style="color:#000000" %) − возвращается информацияоб объектахклиента-родителяавторизованногопользователя и объектах его дочерних клиентов;579 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/]](% style="color:#000000" %){vehicleId} 480 480 481 -(% style="color:#000000" %) − возвращаетинформациюоб объектах с учетомзаданных настроек видимостиобъектов;581 +(% style="color:#000000" %)Параметр запроса: {__**vehicleId**__} - ID ТС 482 482 483 -(% style="color:#000000" %) −информация предоставляется с учетом наличия правна просмотр объектов заблокированныхдоговоров (объекты, принадлежащиезаблокированному договору возвращаются при наличиилюбогоиз прав «Видимость объектов заблокированныхдоговоров в панели управления» или «Видимостьобъектовзаблокированных договоров в мониторинге»;583 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 484 484 485 -(% style="color:#000000" %) − информация о телефонах SIM1/SIM2 предоставляется приналичии права«Просмотр номеров телефоновобъектов»;585 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 486 486 487 -(% style="color:#000000" %) − информация о статусе объекта предоставляется при наличии права «Просмотр статуса объекта».587 +(% style="color:#000000" %){ 488 488 489 -(% style="color:#000000" %)Метод запроса: **POST** 589 + "status": "", ~/~/ значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 590 + ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 591 + ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 592 + "date": "", ~/~/ Дата смены статуса (null если сменить немедленно) 593 + "description": "", ~/~/ Описание 594 + "data": "", ~/~/ Данные 595 + "overwrite": false, ~/~/ Флаг перезаписи 596 + "stage": "", ~/~/ Состояние, может быть null 490 490 491 -(% style="color:#000000" %) URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/find>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/find]]598 +(% style="color:#000000" %)} 492 492 493 -(% style="color:#000000" %) В заголовках запроса:600 +(% style="color:#000000" %)Ответ: 494 494 495 -(% style="color:#000000" %) − Content-Type: application/json602 +(% style="color:#000000" %){ 496 496 497 -(% style="color:#000000" %)− X-Auth: Токен авторизации 604 + "status": "", ~/~/ значение статуса 605 + "date": "", ~/~/ Дата смены статуса 606 + "description": "", ~/~/ Описание 607 + "data": "", ~/~/ Данные 608 + "overwrite": false, ~/~/ Флаг перезаписи 609 + "stage": "", ~/~/ Состояние 498 498 499 -(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON): 611 +(% style="text-align:left" %) 612 +(% style="color:#000000" %) } 500 500 501 -(% class="western" style="color:#000000" %)##{"vehicleId": null,~/~/84350, ~/~/ ID ТС (int, опционально) "name": null, ~/~/ Имя ТС (string, опционально) "imei": null,~/~/"710179307",## 502 502 503 -(% class="western" style="color:#000000" %)##~/~/ IMEI (string, опционально) "sim": null, ~/~/"938112", ~/~/ Номер телефона (string, опционально) "deviceTypeId": null,~/~/5## 615 +(% class="box warningmessage" %) 616 +((( 617 +(% style="color:#000000; line-height:100%" %)**Редактирование объекта — **(% lang="en-US" %)**PUT /api/v3/vehicles** 618 +))) 504 504 505 -(% class="western" style="color:#000000" %)##~/~/IDтипаустройства(short,опционально)"parentId": null,~/~/IDклиента(Guid,опционально)"unitId": null##620 +(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 506 506 507 -(% class="western" style="color:#000000" %)##~/~/"b33548c3-73c3-40e4-8b78-81470ae744ed" ~/~/ ID подразделения(Guid, опционально)##(% style="color:#000000"%)}622 +(% style="color:#000000" %)Метод запроса: **PUT** 508 508 509 -(% style="color:#000000" %) Фильтрация осуществляетсяпоточномусовпадениюзначений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права «Просмотр номеров телефонов объектов».624 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles>>url:https://hosting.glonasssoft.ru/api/v3/vehicles]] 510 510 511 -(% style="color:#000000" %) Ответ:[ { «vehicleId»: «», //идентификаторобъекта «name»: «», // наименование объекта«imei»: «», // IMEI объекта«deviceTypeId»: «», // идентификатор типа устройства«deviceTypeName»:«», // наименование типа устройства «sim1»: «», // первый номер телефона «sim2»: «», //второй номер телефона «parentId»: «», //идентификатор клиента-родителя «parentName»:«», //наименованиеклиента-родителя«modelId»: «», //идентификатор модели объекта «modelName»: «», //наименование модели объекта «unitId»: «», //идентификаторподразделения «unitName»: «», //наименование подразделения «status»: «», // статус объекта //«//createdAt//»: «» дата создания объектов //}, … ]626 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 512 512 513 -(% style="color:#000000" %) «sim1» и «sim2» содержатсявответе при наличии у авторизованного пользователяправа **«Просмотр номеров телефонов объектов»**. Параметр «status» содержится в ответе при наличии у авторизованногопользователя права **«Просмотр статусаобъекта»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:628 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 514 514 515 -(% style="color:#000000" %) 0- «Блокировка»630 +(% style="color:#000000" %){ 516 516 517 -(% style="color:#000000" %)1 - «Активен», 632 +(% style="color:#000000" %) "vehicleId": "", ~/~/ ID ТС 633 + "parentId": "", ~/~/ ID клиента 634 + "name": "", ~/~/ имя ТС 635 + "imei": "", ~/~/ IMEI 636 + "deviceTypeId": "", ~/~/ ID типа устройства 637 + "modelId": "", ~/~/ , ID модели 638 + "unitId": "", ~/~/ подразделения 639 + "sim1": "", ~/~/ SIM 1 640 + "sim2": "", ~/~/ SIM2 641 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 642 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 643 + "counters": 644 + { 645 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 646 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 647 + "mileage": «», пробег 648 + "motohours": «» моточасы 649 + } 650 + "cmsv6Parameters": ~/~/ параметры CMSv6 651 + { 652 + "id": "", ~/~/ идентификатор 653 + "enabled": true, ~/~/ флаг включения 654 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 655 + "login": "", ~/~/ имя учетной записи 656 + "password": "", ~/~/ пароль учетной записи 657 + } 658 + "inspectionTasks": ~/~/ задания на ТО 659 + { 660 + "id": "", ~/~/ ID задания 661 + "enabled": false, ~/~/ Признак включения 662 + "name": "", ~/~/ Имя задания 663 + "description": "", ~/~/ Описание задания 664 + "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает) 665 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно) 666 + "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает) 667 + "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно) 668 + "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 669 + "kind": "", ~/~/ Вид периодичности по времени 670 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 671 + } 518 518 519 -(% style="color:#000000" %) 2 - «Отменен»673 +(% style="color:#000000" %)} 520 520 521 -(% style="color:#000000" %) 3 - «Оборудован»675 +(% style="color:#000000" %)Ответ: 522 522 523 -(% style="color:#000000" %)4 - «Диагностика» 677 +(% lang="en-US" style="text-align:left" %) 678 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 524 524 525 -(% style="color:#000000" %)5 - «Сервис» 680 +(% lang="en-US" style="text-align:left" %) 681 + "vehicleId": "", ~/~/ ID ТС 682 + "parentId": "", ~/~/ ID клиента 683 + "name": "", ~/~/ имя ТС 684 + "imei": "", ~/~/ IMEI 685 + "deviceTypeId": "", ~/~/ типа устройства 686 + "modelId": "", ~/~/ ID модели 687 + "unitId": "", ~/~/ ID подразделения 688 + "sim1": "", ~/~/ SIM 1 689 + "sim2": "", ~/~/ SIM2 690 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 691 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 692 + "counters": 693 + { 694 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 695 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 696 + "mileage": "", ~/~/ пробег 697 + "motohours": "", ~/~/ моточасы 698 + } 699 + "cmsv6Parameters": ~/~/ параметры CMSv6 700 + { 701 + "id": ~/~/ идентификатор 702 + "enabled": true, ~/~/ флаг включения 703 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 704 + "login": "", ~/~/ имя учетной записи 705 + "password": "", ~/~/ пароль учетной записи 706 + } 707 + "inspectionTasks": ~/~/ задания на ТО 708 + { 709 + "id": "", ~/~/ ID задания 710 + "enabled": false, ~/~/ Признак включения 711 + "name": "", ~/~/ Имя задания 712 + "description": "", ~/~/ Описание задания 713 + "mileageCondition": "", ~/~/ Условие по пробегу 714 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 715 + "motohoursCondition": "", ~/~/ Условие по моточасам 716 + "lastMotohours": "", ~/~/ Моточасы 717 + "periodicCondition": "", ~/~/ Условие периодичности по времени 718 + "kind": "", ~/~/ Вид периодичности по времени 719 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 720 + } 526 526 527 -(% style="color:#000000" %)6 - «Демонтаж» 722 +(% lang="en-US" style="text-align:left" %) 723 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 528 528 529 -(% style="color:#000000" %)7 - «Монтаж» 530 530 531 -(% style="color:#000000" %)8 - «Дозаказ» 726 +(% class="box errormessage" %) 727 +((( 728 +(% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 729 +))) 532 532 533 -(% style="color:#000000" %) 9-«Обслужен»731 +(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 534 534 535 -(% style="color:#000000" %) 10- «Списан»733 +(% style="color:#000000" %)Метод запроса: **DELETE** 536 536 537 -(% style="color:#000000" %) 11 - «Неисправен»735 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){vehicleId} 538 538 539 -(% style="color:#000000" %) 12-«Проверен»737 +(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid объекта 540 540 739 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 740 + 541 541 (% style="text-align:left" %) 542 -(% style="color:#000000 ; font-weight:normal" %)13-«Неэксплуатируется»742 +(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 543 543 544 544 545 -(% class="box successmessage" %)745 +(% class="box" lang="en-US" style="text-align: center;" %) 546 546 ((( 547 -(% style="color:#000000; line-height:100%" %)**Изменениестатусаобъекта—**(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}**747 +(% style="color:#000000; font-size:14pt" %)**Раздел Устройства** 548 548 ))) 549 549 550 -(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 750 +(% class="box infomessage" %) 751 +((( 752 +(% style="color:#000000; line-height:100%" %)**Получение списка типов устройств **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/devices/types** 753 +))) 551 551 552 -(% style="color:#000000" %)Метод запроса :**POST**755 +(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 553 553 554 -(% style="color:#000000" %) URLзапроса:(%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/]](% style="color:#000000" %){vehicleId}757 +(% style="color:#000000" %)Метод запроса: **GET** 555 555 556 -(% style="color:#000000" %) Параметрзапроса:{vehicleId} - ID ТС759 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]] 557 557 558 558 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 559 559 560 -(% style="color:#000000" %) Параметрывтеле запроса (JSON):{763 +(% style="color:#000000" %)Ответ: 561 561 562 -(% class="western" %) 563 -{{{ "status": "", // значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 564 - "date": "", // Дата смены статуса (null если сменить немедленно) 565 - "description": "", // Описание 566 - "data": "", // Данные 567 - "overwrite": false, // Флаг перезаписи 568 - "stage": "", // Состояние, может быть null}}} 765 +(% style="color:#000000" %){ 569 569 767 + "deviceTypeId" : "", ~/~/ ID типа устройства 768 + "deviceTypeName" : "" ~/~/ Название типа устройства 769 + 770 +(% style="text-align:left" %) 570 570 (% style="color:#000000" %)} 571 571 572 -(% style="color:#000000" %)Ответ: { 573 573 574 -(% class="western" %) 575 -{{{ "status": "", // значение статуса 576 - "date": "", // Дата смены статуса 577 - "description": "", // Описание 578 - "data": "", // Данные 579 - "overwrite": false, // Флаг перезаписи 580 - "stage": "", // Состояние}}} 774 +(% class="box" style="text-align: center;" %) 775 +((( 776 +(% style="color:#000000; font-size:14pt" %)**Раздел Датчики** 777 +))) 581 581 779 +(% class="box infomessage" %) 780 +((( 781 +(% style="color:#000000; line-height:100%" %)**Получение списка типов датчиков **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/sensors/types** 782 +))) 783 + 784 +(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 785 + 786 +(% style="color:#000000" %)Метод запроса: **GET** 787 + 788 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/sensors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]] 789 + 790 +(% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации 791 + 792 +(% style="color:#000000" %)Ответ: 793 + 794 +(% style="color:#000000" %){ 795 + 796 + "id": "", ~/~/ ID типа датчика 797 + "name": "", ~/~/ Название 798 + "description": "", ~/~/ Описание 799 + 582 582 (% style="text-align:left" %) 583 583 (% style="color:#000000" %)} 584 584