Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/01/30 15:11
on 2024/01/30 15:11
edited by Андрей Калиновский
on 2024/03/26 10:45
on 2024/03/26 10:45
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -60,6 +60,9 @@ 60 60 |(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации 61 61 |(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя 62 62 63 +(% class="wikigeneratedid" %) 64 +Для сквозной (/бесшовной) авторизации добавьте токен в ссылку, чтобы попасть сразу в клиент: [[https:~~/~~/hosting.glonasssoft.ru/login?authId={AUTH_ID}>>https://hosting.glonasssoft.ru/login?authId={AUTH_ID}]] 65 + 63 63 == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) == 64 64 65 65 (% class="box infomessage" %) ... ... @@ -1928,8 +1928,13 @@ 1928 1928 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1929 1929 |protocolType|Тип протокола 1930 1930 |inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный 1931 -|inputNumber|Номер входа 1934 +|inputNumber|((( 1935 +Номер входа 1936 +))) 1932 1932 1938 +(% class="wikigeneratedid" %) 1939 +Перечень ID протоколов в статье - [[ID протоколов для получения типов и номеров входа сырого параметра.>>https://wiki.glonasssoft.ru/bin/view/API/ID%20%D0%BF%D1%80%D0%BE%D1%82%D0%BE%D0%BA%D0%BE%D0%BB%D1%8B%20%D0%B4%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D1%82%D0%B8%D0%BF%D0%B0%20%D0%B8%20%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D0%B0%20%D0%B2%D1%85%D0%BE%D0%B4%D0%B0%20%D1%81%D1%8B%D1%80%D0%BE%D0%B3%D0%BE%20%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0/]] 1940 + 1933 1933 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1934 1934 1935 1935 (% class="box infomessage" %) ... ... @@ -2136,11 +2136,11 @@ 2136 2136 ] 2137 2137 2138 2138 2139 -(% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов** 2147 +== (% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов**(%%) == 2140 2140 2141 2141 (% class="box infomessage" %) 2142 2142 ((( 2143 -**POST/api/v3/vehicles/moveStop** 2151 +**POST /api/v3/vehicles/moveStop** 2144 2144 ))) 2145 2145 2146 2146 Метод запроса: **POST** ... ... @@ -2164,7 +2164,6 @@ 2164 2164 2165 2165 } 2166 2166 2167 - 2168 2168 Ответ: 2169 2169 2170 2170 [ ... ... @@ -2220,6 +2220,45 @@ 2220 2220 2221 2221 ] 2222 2222 2230 + 2231 + 2232 +== (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2233 + 2234 +(% class="box infomessage" %) 2235 +((( 2236 +**POST /api/v3/vehicles/getlastdata** 2237 +))) 2238 + 2239 +Метод запроса: **POST** 2240 + 2241 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/getlastdata 2242 + 2243 +В заголовках запроса: X-Auth: Токен авторизации 2244 + 2245 + 2246 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2247 + 2248 +Ответ: 2249 + { 2250 + "vehicleId": 0, ~/~/Идентификатор объекта. 2251 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2252 + "vehicleNumber": "string",~/~/Номер объекта. 2253 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2254 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2255 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2256 + "speed": 0,~/~/Скорость объекта. 2257 + "course": 0,~/~/Курс движения [0;360] 2258 + "latitude": 0,~/~/Широта [-90°;90°]. 2259 + "longitude": 0,~/~/Долгота [-180°;180°]. 2260 + "address": "string",~/~/Адрес. 2261 + "geozones": [ ~/~/Сведения по геозонам. 2262 + { 2263 + "id": 0, 2264 + "name": "string" 2265 + } 2266 + 2267 + 2268 + 2223 2223 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2224 2224 2225 2225 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -4002,6 +4002,152 @@ 4002 4002 |driverName|Имя водителя 4003 4003 |driverRfid|Номер Карты-метки 4004 4004 4051 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4052 + 4053 +== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == 4054 + 4055 +Транзакции по топливным картам можно получить при наличии права «Транзакции ТК» 4056 + 4057 +(% class="box infomessage" %) 4058 +((( 4059 +**POST**/api/v3/fuelcards/transactions 4060 +))) 4061 + 4062 +Запрос должен содержать параметры: 4063 + 4064 +{ 4065 + 4066 + "startDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата начала периода построения 4067 + 4068 + "endDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата окончания периода построения 4069 + 4070 + "ids": [ 4071 + 4072 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid-ы топливных карт 4073 + 4074 + ], 4075 + 4076 + "timezone": 0, ~/~/ Часовой пояс 4077 + 4078 + "agent": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid клиента владельца 4079 + 4080 +} 4081 + 4082 +Ответ: 4083 + 4084 + { 4085 + 4086 + "date": "2024-03-14T13:14:26.212Z", ~/~/ Дата транзакции 4087 + 4088 + " driver ": "string", ~/~/ Имя водителя 4089 + 4090 + "amount": 0, ~/~/ Количество топлива 4091 + 4092 + "amountDut": 0, ~/~/ Количество топлива по ДУТ 4093 + 4094 + "amountDiff": 0, ~/~/ Разница в литрах 4095 + 4096 + "amountDiffPerc": 0, ~/~/ Разница в % 4097 + 4098 + "summa": 0, ~/~/ Стоимость в руб. 4099 + 4100 + "serviceName": "string", ~/~/ Тип топлива 4101 + 4102 + "price": 0, ~/~/ Цена за литр в руб. 4103 + 4104 + "cardName": "string", ~/~/ Наименование ТК 4105 + 4106 + "cardNum": "string", ~/~/ Номер ТК 4107 + 4108 + "operator": "string", ~/~/ Оператор ТК 4109 + 4110 + "address": "string", ~/~/ Адрес АЗС 4111 + 4112 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid топливной карты 4113 + 4114 + } 4115 + 4116 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 4117 + 4118 +== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 4119 + 4120 + 4121 +(% class="box infomessage" %) 4122 +((( 4123 +GET api/v3/Vehicles/recyclebin/all 4124 +))) 4125 + 4126 +Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту 4127 + 4128 +Параметр запроса: {parentId} - идентификатор агента 4129 + 4130 +В заголовках запроса: X-Auth: Токен авторизации 4131 + 4132 +Ответ: 4133 + 4134 +"recordTime": "2024-03-12T12:40:42.502257Z", - Время удаления объекта в UTC 4135 +"userId": "11111111-c384-43f8-8562-1c3d79a32303", - Пользователь удаливший объект 4136 +"parentId": "f649b532-e519-42da-941e-5fdb3b581482", - GUID агента 4137 +"objectId": "8c79a744-0ba6-4943-8d9e-a9d9509168f2", - GUID объекта 4138 +"objectType": "Vehicle", - Тип объекта 4139 +"details": { 4140 +"items": [ { 4141 +"name": "ObjectName", - наименование столбца 4142 +"value": "01" - содержание столбца 4143 +}, 4144 + 4145 +{ 4146 +"parentName": "string", 4147 +"name": "string", 4148 +"picture": "string", 4149 +"minspeed": 0, 4150 +"maxspeed": 0, 4151 +"width": 0, 4152 +"imbeddedtrailer": true, 4153 +"hoppercapacity": 0, 4154 +"hopperdischargespeed": 0, 4155 +"modelType": 0, 4156 +"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4157 +"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4158 +"deleted": true 4159 +} 4160 + 4161 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 4162 + 4163 +(% class="box infomessage" %) 4164 +((( 4165 +POST/api/v3/Vehicles/recyclebin/erase 4166 +))) 4167 + 4168 +В заголовках запроса: X-Auth: Токен авторизации 4169 + 4170 +Параметры в теле запроса (JSON): 4171 +[ 4172 +"eb737fdf-c422-4df7-8727-bd61439b8460", 4173 +"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3" 4174 +] 4175 + 4176 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 4177 + 4178 +== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) == 4179 + 4180 +(% class="box infomessage" %) 4181 +((( 4182 +POST/api/v3/Vehicles/recyclebin/restore 4183 +))) 4184 + 4185 +В заголовках запроса: X-Auth: Токен авторизации 4186 + 4187 +Параметры в теле запроса (JSON): 4188 +[ 4189 +"eb737fdf-c422-4df7-8727-bd61439b8460", 4190 +"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3" 4191 +] 4192 + 4193 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 4194 + 4195 + 4196 + 4005 4005 (% class="box" lang="en-US" style="text-align: center;" %) 4006 4006 ((( 4007 4007 (% 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]] **