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