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 ... ... @@ -436,7 +436,7 @@ 436 436 "email": "" , ~/~/ E-mail 437 437 "sessionDuration":"", ~/~/ длительность сессии в минутах 438 438 "status": "1", ~/~/ статус пользователя 439 - " lastLogged": "", ~/~/ дата/время последней авторизации439 + "astLogged": "", ~/~/ дата/время последней авторизации 440 440 441 441 (% style="color:#000000" %)} 442 442 ... ... @@ -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 ... ... @@ -701,9 +701,9 @@ 701 701 702 702 (% style="color:#000000" %)Метод запроса: **GET** 703 703 704 -(% 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}704 +(% 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> 705 705 706 -(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__integer($int32))706 +(% style="color:#000000" %)Параметр запроса: <__**vehicleid**__> - идентификатор объекта (опционально) 707 707 708 708 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 709 709 ... ... @@ -717,123 +717,20 @@ 717 717 "deviceTypeId": , ~/~/ ID типа устройства 718 718 "deviceTypeName": "", ~/~/ Название типа устройства 719 719 "sim1": "", ~/~/ Номер SIM1 720 - "sim2": "", ~/~/ Номер SIM2 721 - 722 - "parentId": "", ~/~/ ID клиента-родителя 723 - "parentName": "", ~/~/ Наименование клиента-родителя 724 - "modelId": "", ~/~/ ID модели объекта 725 - "modelName": "", ~/~/ Имя модели объекта 726 - 727 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 728 - "unitName": "string", ~/~/ Наименование подразделения 729 - "status": 0, ~/~/ Статус объекта 730 - 731 - "createdAt": "", ~/~/ Дата создания объекта 720 + "parentId": "", Номер SIM2 721 + "parentName": "", Наименование клиента-родителя 722 + "modelId": "", ID модели объекта 723 + "modelName": "", Имя модели объекта 724 + "createdAt": "", Дата создания объекта 725 + "mileageCalcMethod": "", Выбранный метод расчета пробега 726 + "counters": { ~/~/ Нормы 727 + "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен) 728 + "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен) 729 + "mileage": "", ~/~/ Пробег по нормам в метрах 730 + "motohours": "" ~/~/ Моточасы по нормам, в секундах 731 + "mileageTime": "2023-03-14T11:18:52.696Z", ~/~/ временная метка редактирования/обновления счетчика пробега 732 + "motohoursTime": "2023-03-14T11:18:52.696Z" ~/~/ временная метка редактирования/обновления счетчика моточасов 732 732 }, 733 - 734 -"customFields": [ ~/~/ Произвольные поля 735 - { 736 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 737 - "name": "string", 738 - "value": "string", 739 - "forClient": true, 740 - "forTooltip": true, 741 - "forReport": true 742 - } 743 - 744 -], ~/~/ Данные с вкладки нормы 745 - "consumptionPer100Km": 0, 746 - "consumptionPerHour": 0, 747 - "consumptionIdle": 0, 748 - "consumptionPer100KmSeasonal": 0, 749 - "consumptionPerHourSeasonal": 0, 750 - "consumptionIdleSeasonal": 0, 751 - "consumptionPer100KmSeasonalBegin": "2023-05-22T09:57:39.562Z", 752 - "consumptionPer100KmSeasonalEnd": "2023-05-22T09:57:39.562Z", 753 - "consumptionPerHourSeasonalBegin": "2023-05-22T09:57:39.562Z", 754 - "consumptionPerHourSeasonalEnd": "2023-05-22T09:57:39.562Z", 755 - "consumptionIdleSeasonalBegin": "2023-05-22T09:57:39.562Z", 756 - "consumptionIdleSeasonalEnd": "2023-05-22T09:57:39.562Z", 757 - "mileageCalcMethod": 0, 758 - "mileageCoeff": 0, 759 - "locationByCellId": true, 760 - "dottedLineTrackWhenNoCoords": true, 761 - "counters": { 762 - "mileageEnabled": true, 763 - "motohoursEnabled": true, 764 - "mileage": 0, 765 - "motohours": 0, 766 - "mileageTime": "2023-05-22T09:57:39.562Z", 767 - "motohoursTime": "2023-05-22T09:57:39.562Z" 768 - }, 769 - 770 -"cmsv6Parameters": { ~/~/ Настройки видеомониторинга 771 - "id": "string", 772 - "enabled": true, 773 - "host": "string", 774 - "login": "string", 775 - "password": "string" 776 - }, 777 - 778 -"commandTemplates": [ ~/~/ Шаблоны команд 779 - { 780 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 781 - "name": "string", 782 - "command": "string", 783 - "retries": 0 784 - } 785 - ], 786 - 787 - "sensors": [ ~/~/ Датчики 788 - { 789 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 790 - "kind": 0, 791 - "type": 0, 792 - "name": "string", 793 - "inputType": 0, 794 - "inputNumber": 0, 795 - "pseudonym": "string", 796 - "medianDegree": 0, 797 - "isInverted": true, 798 - "disabled": true, 799 - "gradeType": 0, 800 - "gradesTables": [ 801 - { 802 - "grades": [ 803 - { 804 - "input": 0, 805 - "output": 0 806 - } 807 - ], 808 - "relevanceTime": "2023-05-22T09:57:39.562Z" 809 - } 810 - ], 811 - "showInTooltip": true, 812 - "showLastValid": true, 813 - "showAsDutOnGraph": true, 814 - "showWithoutIgn": true, 815 - "agrFunction": 0, 816 - "expr": "string", 817 - "children": [ 818 - "string" 819 - ], 820 - "customParams": { 821 - "additionalProp1": "string", 822 - "additionalProp2": "string", 823 - "additionalProp3": "string" 824 - }, 825 - "summaryMaxValue": 0 826 - } 827 - 828 - "drivers": [ ~/~/ Водители 829 - { 830 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 831 - "name": "string", 832 - "description": "string", 833 - "isDefault": true 834 - } 835 - ], 836 - 837 837 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 838 838 { 839 839 "id": "", ~/~/ ID задания ... ... @@ -849,17 +849,7 @@ 849 849 "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано) 850 850 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 851 851 } 852 - ], 853 - 854 - "statusHistory": [ ~/~/ История статусов 855 - { 856 - "status": 0, 857 - "date": "2023-05-22T09:57:39.562Z", 858 - "description": "string", 859 - "additionalInfo": "string" 860 - } 861 - ] 862 - 749 + ] 863 863 } 864 864 ))) 865 865 ... ... @@ -876,7 +876,7 @@ 876 876 (% lang="en-US" %)**POST /api/v3/vehicles** 877 877 ))) 878 878 879 -(% style="color:#000000" %)Метод позволяет добавить объект, указанный в запросе. 766 +(% style="color:#000000" %)Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__). 880 880 881 881 (% style="color:#000000" %)Метод запроса: **POST** 882 882 ... ... @@ -998,7 +998,7 @@ 998 998 999 999 (% style="color:#000000" %)Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 1000 1000 1001 -(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе: 888 +(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 1002 1002 1003 1003 (% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов; 1004 1004 ... ... @@ -1078,7 +1078,7 @@ 1078 1078 (% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}** 1079 1079 ))) 1080 1080 1081 -(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе. 968 +(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1082 1082 1083 1083 (% style="color:#000000" %)Метод запроса: **POST** 1084 1084 ... ... @@ -1124,7 +1124,7 @@ 1124 1124 (% lang="en-US" %)**PUT /api/v3/vehicles** 1125 1125 ))) 1126 1126 1127 -(% style="color:#000000" %)Метод позволяет отредактировать объект, указанный в запросе. 1014 +(% style="color:#000000" %)Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1128 1128 1129 1129 (% style="color:#000000" %)Метод запроса: **PUT** 1130 1130 ... ... @@ -1241,7 +1241,7 @@ 1241 1241 (% lang="en-US" style="text-align:left" %) 1242 1242 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1243 1243 1244 -** Валидация:**1131 +**валидация:** 1245 1245 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1246 1246 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1247 1247 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. ... ... @@ -1253,7 +1253,7 @@ 1253 1253 (% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 1254 1254 ))) 1255 1255 1256 -(% style="color:#000000" %)Метод позволяет удалить объект, указанный в строке запроса. 1143 +(% style="color:#000000" %)Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1257 1257 1258 1258 (% style="color:#000000" %)Метод запроса: **DELETE** 1259 1259 ... ... @@ -1275,7 +1275,7 @@ 1275 1275 (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/devices/types** 1276 1276 ))) 1277 1277 1278 -(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе. 1165 +(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1279 1279 1280 1280 (% style="color:#000000" %)Метод запроса: **GET** 1281 1281 ... ... @@ -1302,7 +1302,7 @@ 1302 1302 (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types** 1303 1303 ))) 1304 1304 1305 -(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе. 1192 +(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1306 1306 1307 1307 (% style="color:#000000" %)Метод запроса: **GET** 1308 1308 ... ... @@ -1331,7 +1331,7 @@ 1331 1331 ))) 1332 1332 1333 1333 (% style="text-align: left;" %) 1334 -Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период. 1221 +Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1335 1335 1336 1336 (% style="text-align: left;" %) 1337 1337 Метод запроса **POST** ... ... @@ -1369,7 +1369,7 @@ 1369 1369 **POST /api/v3/terminalMessages** 1370 1370 ))) 1371 1371 1372 -Метод возвращает список сообщений терминала объекта за выбранный период. 1259 +Метод возвращает список сообщений терминала объекта за выбранный период (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 1373 1373 1374 1374 (% style="text-align: left;" %) 1375 1375 Метод запроса **POST** ... ... @@ -1411,206 +1411,7 @@ 1411 1411 } 1412 1412 ] 1413 1413 1414 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 1415 1415 1416 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 1417 - 1418 -(% class="box infomessage" %) 1419 -((( 1420 -**POST /api/v3/notifications/find** 1421 -))) 1422 - 1423 -Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 1424 - 1425 -(% style="text-align: left;" %) 1426 -Метод запроса **POST** 1427 - 1428 -(% style="text-align: left;" %) 1429 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 1430 - 1431 -(% style="text-align: left;" %) 1432 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1433 - 1434 -{ 1435 - "parentId": "" ~/~/ id клиента 1436 -} 1437 - 1438 -Ответ: 1439 - 1440 -[ 1441 - { 1442 - "id": 0, ~/~/ ID уведомления 1443 - "name": "string", ~/~/ Название уведомления 1444 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 1445 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 1446 - "userId": "", ~/~/ Пользователь, создавший уведомление 1447 - "parentId": "", ~/~/ Идентификатор клиента 1448 - "parentName": "string" ~/~/ Имя клиента 1449 - } 1450 -] 1451 - 1452 -== (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 1453 - 1454 -(% class="box infomessage" %) 1455 -((( 1456 -**GET /api/v3/notifications/{id}** 1457 -))) 1458 - 1459 -Метод возвращает данные правил формирования выбранного уведомления. 1460 - 1461 -(% style="text-align: left;" %) 1462 -Метод запроса **GET** 1463 - 1464 -(% style="text-align: left;" %) 1465 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/{id} 1466 - 1467 -(% style="text-align: left;" %) 1468 -(% style="color:#000000" %)Параметр запроса: {**__id__**} - (%%)id уведомления 1469 - 1470 -(% style="text-align: left;" %) 1471 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1472 - 1473 -(% style="text-align: left;" %) 1474 -(% style="color:#000000" %)Ответ: 1475 - 1476 -(% style="text-align: left;" %) 1477 -(% style="color:#000000" %){ 1478 - "id": 0, ~/~/ (%%)id уведомления 1479 -(% style="color:#000000" %) "type": 0, (%%)~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 1480 -(% style="color:#000000" %) "userId": "", /(%%)/ Пользователь, создавший уведомление 1481 -(% style="color:#000000" %) "parentId": "", (%%)~/~/ Идентификатор клиента 1482 -(% style="color:#000000" %) "parentName": "string", (%%)~/~/ Имя клиента 1483 -(% style="color:#000000" %) "name": "string", (%%)~/~/ Название уведомления 1484 -(% style="color:#000000" %) "active": true, (%%)~/~/ Состояние true - активен, false - деактивирован 1485 -(% style="color:#000000" %) "vehicleIds": [ ~/~/ (%%)Список id объектов для анализа 1486 -(% style="color:#000000" %) 0 1487 - ], 1488 - "geoids": [ ~/~/ (%%)Список id геообъектов для анализа 1489 -(% style="color:#000000" %) 0 1490 - ], 1491 - "fieldids": [ ~/~/ (%%)Список id полей для анализа 1492 -(% style="color:#000000" %) 0 1493 - ], 1494 - "settings": { ~/~/ Список параметров уведомления 1495 - "additionalProp1": "string", 1496 - "additionalProp2": "string", 1497 - "additionalProp3": "string" 1498 - }, 1499 - "toEmail": true, ~/~/ (%%)Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 1500 -(% style="color:#000000" %) "recipientIds": [ ~/~/ (%%)Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 1501 -(% style="color:#000000" %) "" 1502 - ], 1503 - "enableSideEmails": true, ~/~/ (%%)Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 1504 -(% style="color:#000000" %) "sideEmails": [ ~/~/ (%%)Список электронных адресов для отсылки уведомлений 1505 -(% style="color:#000000" %) "string" 1506 - ], 1507 - "toTelegram": true, ~/~/ (%%)Флаг активности отправки в Telegram 1508 -(% style="color:#000000" %) "telegrams": [ ~/~/ (%%)Список получателя уведомлений в Telegram. 1509 -(% style="color:#000000" %) { 1510 - "id": 0, ~/~/ (%%)Идентификатор участника чата 1511 -(% style="color:#000000" %) "info": "string" ~/~/ (%%)Дополнительные сведения 1512 -(% style="color:#000000" %) } 1513 - ], 1514 - "toMobile": true, ~/~/ (%%)Флаг активности отправки в мобильное приложение 1515 -(% style="color:#000000" %) "toClient": true, ~/~/ (%%)Флаг активности отправки в интерфейсе системы 1516 -(% style="color:#000000" %) "stored": true, ~/~/ (%%)Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 1517 -(% style="color:#000000" %) "kind": 0, ~/~/ (%%)Определяет вид уведомления 1518 -(% style="color:#000000" %) "activationMode": 0, ~/~/ (%%)Вид активации уведомления 0 - Сейчас, 1 - В определенную дату и время 1519 -(% style="color:#000000" %) "activationTime": "2023-03-29T09:57:48.932Z", ~/~/ (%%)Дата/время активации правила (UTC) 1520 -(% style="color:#000000" %) "timezone": 0, ~/~/ (%%)Сдвиг часового пояса 1521 -(% style="color:#000000" %) "validity": 0, ~/~/ (%%)Срок действия в днях (1-90) 1522 -(% style="color:#000000" %) "autoProlongation": true ~/~/ (%%)Автопродление срока действия 1523 -(% style="color:#000000" %)} 1524 - 1525 -== (% style="color:#000000; font-size:16px" %)**Редактирование уведомления**(%%) == 1526 - 1527 -(% class="box warningmessage" %) 1528 -((( 1529 -**PUT /api/v3/notifications/** 1530 -))) 1531 - 1532 -Метод позволяет отредактировать уведомление. 1533 - 1534 -Метод запроса **PUT** 1535 - 1536 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications 1537 - 1538 -В заголовках запроса: X-Auth: Токен авторизации 1539 - 1540 -Тело запроса: 1541 -{ 1542 - "id": 0, ~/~/ id уведомления 1543 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 1544 - "userId": "", ~/~/ Пользователь, создавший уведомление 1545 - "parentId": "", ~/~/ Идентификатор клиента 1546 - "parentName": "string", ~/~/ Имя клиента 1547 - "name": "string", ~/~/ Название уведомления 1548 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 1549 - "vehicleIds": [ ~/~/ Список id объектов для анализа 1550 - 0 1551 - ], 1552 - "geoids": [ ~/~/ Список id геообъектов для анализа 1553 - 0 1554 - ], 1555 - "fieldids": [ ~/~/ Список id полей для анализа 1556 - 0 1557 - ], 1558 - "settings": { ~/~/ Список параметров уведомления 1559 - "additionalProp1": "string", 1560 - "additionalProp2": "string", 1561 - "additionalProp3": "string" 1562 - }, 1563 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 1564 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 1565 - "" 1566 - ], 1567 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 1568 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 1569 - "string" 1570 - ], 1571 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 1572 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 1573 - { 1574 - "id": 0, ~/~/ Идентификатор участника чата 1575 - "info": "string" ~/~/ Дополнительные сведения 1576 - } 1577 - ], 1578 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 1579 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 1580 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 1581 - "kind": 0, ~/~/ Определяет вид уведомления 1582 - "activationMode": 0, ~/~/ Вид активации уведомления 0 - Сейчас, 1 - В определенную дату и время 1583 - "activationTime": "2023-03-29T09:57:48.932Z", ~/~/ Дата и время активации правила (UTC) 1584 - "timezone": 0, ~/~/ Сдвиг часового пояса 1585 - "validity": 0, ~/~/ Срок действия в днях (1-90) 1586 - "autoProlongation": true ~/~/ Автопродление срока действия 1587 -} 1588 - 1589 -Ответ: 1590 - 1591 -Success 1592 - 1593 -== (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 1594 - 1595 -(% class="box errormessage" %) 1596 -((( 1597 -**DELETE /api/v3/notifications/{id}** 1598 -))) 1599 - 1600 -Метод позволяет удалить выбранное уведомление. 1601 - 1602 -Метод запроса **DELETE** 1603 - 1604 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/{id} 1605 - 1606 -Передаваемый параметр: {id} - id уведомления 1607 - 1608 -В заголовках запроса: X-Auth: Токен авторизации 1609 - 1610 -Ответ: 1611 - 1612 -Success 1613 - 1614 1614 (% class="box" lang="en-US" style="text-align: center;" %) 1615 1615 ((( 1616 1616 (% 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]] **