Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/02/28 10:46
on 2024/02/28 10:46
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" %) ... ... @@ -2235,7 +2235,7 @@ 2235 2235 В заголовках запроса: X-Auth: Токен авторизации 2236 2236 2237 2237 2238 -В теле запроса перечисляете массив id объектов 2246 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2239 2239 2240 2240 Ответ: 2241 2241 { ... ... @@ -2244,7 +2244,7 @@ 2244 2244 "vehicleNumber": "string",~/~/Номер объекта. 2245 2245 "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2246 2246 "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2247 - "state": 0,~/~/Определяет состояния объекта в мониторинге: вдвижении,остановка,стоянка,отключена,нетданных.2255 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2248 2248 "speed": 0,~/~/Скорость объекта. 2249 2249 "course": 0,~/~/Курс движения [0;360] 2250 2250 "latitude": 0,~/~/Широта [-90°;90°]. ... ... @@ -4040,6 +4040,152 @@ 4040 4040 |driverName|Имя водителя 4041 4041 |driverRfid|Номер Карты-метки 4042 4042 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 + 4043 4043 (% class="box" lang="en-US" style="text-align: center;" %) 4044 4044 ((( 4045 4045 (% 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]] **