Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/02/28 14:14
on 2024/02/28 14:14
edited by Андрей Калиновский
on 2024/04/11 14:20
on 2024/04/11 14:20
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>>url:https://hosting.glonasssoft.ru/login?authId={AuthId}]] / [[https:~~/~~/regions.glonasssoft.ru>>url:https://hosting.glonasssoft.ru/login?authId={AuthId}]]) добавьте токен авторизации - {AuthId}, чтобы попасть сразу в клиента ([[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" %) ... ... @@ -1428,7 +1428,7 @@ 1428 1428 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1429 1429 ))) 1430 1430 1431 -(% style="color:#000000" %)Метод позволяет получить основные параметр ы объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).1434 +(% style="color:#000000" %)Метод позволяет получить список доступных объектов мониторинга (транспортных средств) с их основными параметрами: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 1432 1432 1433 1433 (% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе: 1434 1434 ... ... @@ -1933,7 +1933,7 @@ 1933 1933 ))) 1934 1934 1935 1935 (% class="wikigeneratedid" %) 1936 -Перечень ID протоколов в статье - ID протоколов для получения типов и номеров входа сырого параметра. 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/]] 1937 1937 1938 1938 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1939 1939 ... ... @@ -2240,7 +2240,7 @@ 2240 2240 В заголовках запроса: X-Auth: Токен авторизации 2241 2241 2242 2242 2243 -В теле запроса перечисляете массив id объектов 2246 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2244 2244 2245 2245 Ответ: 2246 2246 { ... ... @@ -2249,7 +2249,7 @@ 2249 2249 "vehicleNumber": "string",~/~/Номер объекта. 2250 2250 "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2251 2251 "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2252 - "state": 0,~/~/Определяет состояния объекта в мониторинге: вдвижении,остановка,стоянка,отключена,нетданных.2255 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2253 2253 "speed": 0,~/~/Скорость объекта. 2254 2254 "course": 0,~/~/Курс движения [0;360] 2255 2255 "latitude": 0,~/~/Широта [-90°;90°]. ... ... @@ -4045,6 +4045,155 @@ 4045 4045 |driverName|Имя водителя 4046 4046 |driverRfid|Номер Карты-метки 4047 4047 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 +Метод запроса: POST 4063 + 4064 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards/transactions 4065 +\\В заголовках запроса: X-Auth: Токен авторизации 4066 + 4067 +Параметры в теле запроса (JSON): 4068 + 4069 +{ 4070 + 4071 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4072 + 4073 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4074 + 4075 + "ids": [ 4076 + 4077 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4078 + 4079 + ], 4080 + 4081 + "timezone": 0 ~/~/Таймзона 4082 + 4083 +} 4084 + 4085 +Ответ: 4086 + 4087 + { 4088 + 4089 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4090 + 4091 + "driver": "string", ~/~/Водители, привязанные к ТК 4092 + 4093 + "object": "string", ~/~/Наименование ТС 4094 + 4095 + "amount": 0, ~/~/Количество топлива 4096 + 4097 + "amountDut": 0, ~/~/Количество по ДУТ 4098 + 4099 + "amountDiff": 0, ~/~/Разница, л 4100 + 4101 + "amountDiffPerc": 0, ~/~/Разница, % 4102 + 4103 + "summa": 0, ~/~/Стоимость, руб 4104 + 4105 + "serviceName": "string", ~/~/Тип топлива 4106 + 4107 + "price": 0, ~/~/Цена за литр, руб 4108 + 4109 + "cardName": "string", ~/~/Наименование ТК 4110 + 4111 + "cardNum": "string", ~/~/Номер ТК 4112 + 4113 + "operator": "string", ~/~/Оператор ТК 4114 + 4115 + "address": "string" ~/~/Адрес АЗС 4116 + 4117 + } 4118 + 4119 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 4120 + 4121 +== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 4122 + 4123 + 4124 +(% class="box infomessage" %) 4125 +((( 4126 +GET api/v3/Vehicles/recyclebin/all 4127 +))) 4128 + 4129 +Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту 4130 + 4131 +Параметр запроса: {parentId} - идентификатор агента 4132 + 4133 +В заголовках запроса: X-Auth: Токен авторизации 4134 + 4135 +Ответ: 4136 + 4137 +"recordTime": "2024-03-12T12:40:42.502257Z", - Время удаления объекта в UTC 4138 +"userId": "11111111-c384-43f8-8562-1c3d79a32303", - Пользователь удаливший объект 4139 +"parentId": "f649b532-e519-42da-941e-5fdb3b581482", - GUID агента 4140 +"objectId": "8c79a744-0ba6-4943-8d9e-a9d9509168f2", - GUID объекта 4141 +"objectType": "Vehicle", - Тип объекта 4142 +"details": { 4143 +"items": [ { 4144 +"name": "ObjectName", - наименование столбца 4145 +"value": "01" - содержание столбца 4146 +}, 4147 + 4148 +{ 4149 +"parentName": "string", 4150 +"name": "string", 4151 +"picture": "string", 4152 +"minspeed": 0, 4153 +"maxspeed": 0, 4154 +"width": 0, 4155 +"imbeddedtrailer": true, 4156 +"hoppercapacity": 0, 4157 +"hopperdischargespeed": 0, 4158 +"modelType": 0, 4159 +"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4160 +"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4161 +"deleted": true 4162 +} 4163 + 4164 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 4165 + 4166 +(% class="box infomessage" %) 4167 +((( 4168 +POST/api/v3/Vehicles/recyclebin/erase 4169 +))) 4170 + 4171 +В заголовках запроса: X-Auth: Токен авторизации 4172 + 4173 +Параметры в теле запроса (JSON): 4174 +[ 4175 +"eb737fdf-c422-4df7-8727-bd61439b8460", 4176 +"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3" 4177 +] 4178 + 4179 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 4180 + 4181 +== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) == 4182 + 4183 +(% class="box infomessage" %) 4184 +((( 4185 +POST/api/v3/Vehicles/recyclebin/restore 4186 +))) 4187 + 4188 +В заголовках запроса: X-Auth: Токен авторизации 4189 + 4190 +Параметры в теле запроса (JSON): 4191 +[ 4192 +"eb737fdf-c422-4df7-8727-bd61439b8460", 4193 +"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3" 4194 +] 4195 + 4196 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 4197 + 4198 + 4199 + 4048 4048 (% class="box" lang="en-US" style="text-align: center;" %) 4049 4049 ((( 4050 4050 (% 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]] **