Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/02/20 09:52
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -62,7 +62,7 @@ 62 62 (% lang="en-US" %)**GET /api/v3/auth/check** 63 63 ))) 64 64 65 -(% style="color:#000000" %)Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет. 65 +(% style="color:#000000" %)Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 66 66 67 67 (% style="color:#000000" %)Метод запроса: **GET** 68 68 ... ... @@ -82,7 +82,7 @@ 82 82 **GET api/v3/agents/{id}** 83 83 ))) 84 84 85 -Метод позволяет получить параметры выбранного клиента(% style="color:#000000" %): наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе: 85 +Метод позволяет получить параметры выбранного клиента(% style="color:#000000" %): наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 86 86 87 87 (% style="color:#000000" %)− информация о клиенте предоставляется при наличии права «Просмотр клиентов»; 88 88 ... ... @@ -124,7 +124,7 @@ 124 124 (% lang="en-US" %)**POST **(%%)**/(% lang="en-US" %)api/v3/agents/find(%%)** 125 125 ))) 126 126 127 -(% style="color:#000000" %)Метод позволяет получить параметры всех дочерних клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе: 127 +(% style="color:#000000" %)Метод позволяет получить параметры всех дочерних клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 128 128 129 129 (% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»; 130 130 ... ... @@ -161,7 +161,7 @@ 161 161 **POST /api/v3/agents ** 162 162 ))) 163 163 164 -Метод позволяет добавить клиента, указанного в запросе. 164 +Метод позволяет добавить клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»). 165 165 166 166 Метод запроса: **POST** 167 167 ... ... @@ -224,7 +224,7 @@ 224 224 **PUT /api/v3/agents** 225 225 ))) 226 226 227 -Метод позволяет отредактировать клиента, указанного в запросе. 227 +Метод позволяет отредактировать клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»). 228 228 229 229 Метод запроса: **PUT** 230 230 ... ... @@ -288,7 +288,7 @@ 288 288 **DELETE /api/v3/agents/{clientId}** 289 289 ))) 290 290 291 -Метод позволяет удалить клиента, указанного в строке запроса. 291 +Метод позволяет удалить клиента, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»). 292 292 293 293 Метод запроса: **DELETE** 294 294 ... ... @@ -309,7 +309,7 @@ 309 309 (% lang="en-US" %)**POST /api/v3/users** 310 310 ))) 311 311 312 -(% style="color:#000000" %)Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе. 312 +(% style="color:#000000" %)Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 313 313 314 314 (% style="color:#000000" %)Метод запроса: **POST** 315 315 ... ... @@ -499,7 +499,7 @@ 499 499 (% lang="en-US" %)**PUT /api/v3/users** 500 500 ))) 501 501 502 -(% style="color:#000000" %)Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе. 502 +(% style="color:#000000" %)Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 503 503 504 504 (% style="color:#000000" %)Метод запроса: **PUT** 505 505 ... ... @@ -580,7 +580,7 @@ 580 580 (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 581 581 ))) 582 582 583 -(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе. 583 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 584 584 585 585 (% style="color:#000000" %)Метод запроса: **PUT** 586 586 ... ... @@ -610,7 +610,7 @@ 610 610 **POST /api/v3/users/disable** 611 611 ))) 612 612 613 -Метода позволяет выполнить массовую блокировку пользователей(% style="color:#000000" %). 613 +Метода позволяет выполнить массовую блокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 614 614 615 615 (% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST** 616 616 ... ... @@ -632,7 +632,7 @@ 632 632 **POST /api/v3/users/enable** 633 633 ))) 634 634 635 -Метода позволяет выполнить массовую разблокировку пользователей(% style="color:#000000" %). 635 +Метода позволяет выполнить массовую разблокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 636 636 637 637 (% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST** 638 638 ... ... @@ -669,7 +669,7 @@ 669 669 (% lang="en-US" %)**DELETE /api/v3/users/{id}** 670 670 ))) 671 671 672 -(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 672 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 673 673 674 674 (% style="color:#000000" %)Метод запроса: **DELETE** 675 675 ... ... @@ -693,7 +693,7 @@ 693 693 694 694 (% style="color:#000000" %)Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение». 695 695 696 -(% style="color:#000000" %)Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе: 696 +(% style="color:#000000" %)Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 697 697 698 698 (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов; 699 699 ... ... @@ -763,7 +763,7 @@ 763 763 (% lang="en-US" %)**POST /api/v3/vehicles** 764 764 ))) 765 765 766 -(% style="color:#000000" %)Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе. 766 +(% style="color:#000000" %)Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__). 767 767 768 768 (% style="color:#000000" %)Метод запроса: **POST** 769 769 ... ... @@ -885,7 +885,7 @@ 885 885 886 886 (% style="color:#000000" %)Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 887 887 888 -(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе: 888 +(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 889 889 890 890 (% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов; 891 891 ... ... @@ -965,7 +965,7 @@ 965 965 (% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}** 966 966 ))) 967 967 968 -(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе. 968 +(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 969 969 970 970 (% style="color:#000000" %)Метод запроса: **POST** 971 971 ... ... @@ -1011,7 +1011,7 @@ 1011 1011 (% lang="en-US" %)**PUT /api/v3/vehicles** 1012 1012 ))) 1013 1013 1014 -(% style="color:#000000" %)Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе. 1014 +(% style="color:#000000" %)Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1015 1015 1016 1016 (% style="color:#000000" %)Метод запроса: **PUT** 1017 1017 ... ... @@ -1128,7 +1128,7 @@ 1128 1128 (% lang="en-US" style="text-align:left" %) 1129 1129 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1130 1130 1131 -** Валидация:**1131 +**валидация:** 1132 1132 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1133 1133 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1134 1134 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. ... ... @@ -1140,7 +1140,7 @@ 1140 1140 (% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 1141 1141 ))) 1142 1142 1143 -(% style="color:#000000" %)Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса. 1143 +(% style="color:#000000" %)Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1144 1144 1145 1145 (% style="color:#000000" %)Метод запроса: **DELETE** 1146 1146 ... ... @@ -1162,7 +1162,7 @@ 1162 1162 (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/devices/types** 1163 1163 ))) 1164 1164 1165 -(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе. 1165 +(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1166 1166 1167 1167 (% style="color:#000000" %)Метод запроса: **GET** 1168 1168 ... ... @@ -1189,7 +1189,7 @@ 1189 1189 (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types** 1190 1190 ))) 1191 1191 1192 -(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе. 1192 +(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1193 1193 1194 1194 (% style="color:#000000" %)Метод запроса: **GET** 1195 1195 ... ... @@ -1218,7 +1218,7 @@ 1218 1218 ))) 1219 1219 1220 1220 (% style="text-align: left;" %) 1221 -Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период. 1221 +Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1222 1222 1223 1223 (% style="text-align: left;" %) 1224 1224 Метод запроса **POST** ... ... @@ -1249,14 +1249,16 @@ 1249 1249 } 1250 1250 ] 1251 1251 1252 -== (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1253 1253 1253 +(% style="text-align: left;" %) 1254 +(% style="color:#000000; font-size:16px" %)**Запрос списка сообщений** 1255 + 1254 1254 (% class="box infomessage" %) 1255 1255 ((( 1256 1256 **POST /api/v3/terminalMessages** 1257 1257 ))) 1258 1258 1259 -Метод возвращает список сообщений терминала объекта за выбранный период. 1261 +Метод возвращает список сообщений терминала объекта за выбранный период (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1260 1260 1261 1261 (% style="text-align: left;" %) 1262 1262 Метод запроса **POST** ... ... @@ -1298,113 +1298,7 @@ 1298 1298 } 1299 1299 ] 1300 1300 1301 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 1302 1302 1303 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 1304 - 1305 -POST /api/v3/notifications/find 1306 - 1307 -Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 1308 - 1309 -(% style="text-align: left;" %) 1310 -Метод запроса **POST** 1311 - 1312 -(% style="text-align: left;" %) 1313 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 1314 - 1315 -(% style="text-align: left;" %) 1316 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1317 - 1318 -{ 1319 - "parentId": "" ~/~/ id клиента 1320 -} 1321 - 1322 -Ответ: 1323 - 1324 -[ 1325 - { 1326 - "id": 0, 1327 - "name": "string", 1328 - "active": true, 1329 - "type": 0, 1330 - "userId": "", 1331 - "parentId": "", 1332 - "parentName": "string" 1333 - } 1334 -] 1335 - 1336 - 1337 -Запрос настроек уведомления 1338 - 1339 -GET /api/v3/notifications/{id} 1340 - 1341 -Метод возвращает данные правил формирования выбранного уведомления. 1342 - 1343 -(% style="text-align: left;" %) 1344 -Метод запроса **GET** 1345 - 1346 -(% style="text-align: left;" %) 1347 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/notifications/find{id}>>https://hosting.glonasssoft.ru/api/v3/notifications/find{id}]] 1348 - 1349 -(% style="text-align: left;" %) 1350 -(% style="color:#000000" %)Параметр запроса: {**__id__**} - (%%)id уведомления 1351 - 1352 -(% style="text-align: left;" %) 1353 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1354 - 1355 -(% style="text-align: left;" %) 1356 -(% style="color:#000000" %)Ответ: 1357 - 1358 -(% style="text-align: left;" %) 1359 -(% style="color:#000000" %){ 1360 - "id": 0, 1361 - "type": 0, 1362 - "userId": "", 1363 - "parentId": "", 1364 - "parentName": "string", 1365 - "name": "string", 1366 - "active": true, 1367 - "vehicleIds": [ 1368 - 0 1369 - ], 1370 - "geoids": [ 1371 - 0 1372 - ], 1373 - "fieldids": [ 1374 - 0 1375 - ], 1376 - "settings": { 1377 - "additionalProp1": "string", 1378 - "additionalProp2": "string", 1379 - "additionalProp3": "string" 1380 - }, 1381 - "toEmail": true, 1382 - "recipientIds": [ 1383 - "" 1384 - ], 1385 - "enableSideEmails": true, 1386 - "sideEmails": [ 1387 - "string" 1388 - ], 1389 - "toTelegram": true, 1390 - "telegrams": [ 1391 - { 1392 - "id": 0, 1393 - "info": "string" 1394 - } 1395 - ], 1396 - "toMobile": true, 1397 - "toClient": true, 1398 - "stored": true, 1399 - "kind": 0, 1400 - "activationMode": 0, 1401 - "activationTime": "2023-03-29T09:57:48.932Z", 1402 - "timezone": 0, 1403 - "validity": 0, 1404 - "autoProlongation": true 1405 -} 1406 - 1407 - 1408 1408 (% class="box" lang="en-US" style="text-align: center;" %) 1409 1409 ((( 1410 1410 (% 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]] **