Changes for page Методы API для работы с ГЛОНАССSoft

Last modified by Андрей Калиновский on 2025/01/28 12:59

From version < 140.1 >

edited by Андрей Калиновский
on 2024/02/28 10:31

To version < 152.1 >

edited by Андрей Калиновский
on 2024/03/26 12:01

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -60,6 +60,9 @@
  |(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации
  |(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя
++(% class="wikigeneratedid" %)
++Также  имеется возможность сквозной (/бесшовной) авторизации. Для этого к ссылке ( [[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}]])
++
  == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) ==
  (% class="box infomessage" %)
@@ -1928,8 +1928,13 @@
  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
  |protocolType|Тип протокола
  |inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный
--|inputNumber|Номер входа
++|inputNumber|(((
++Номер входа
++)))
++(% class="wikigeneratedid" %)
++Перечень 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/]]
++
  == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) ==
  (% class="box infomessage" %)
@@ -2235,21 +2235,8 @@
  В заголовках запроса: X-Auth: Токен авторизации
--Тело запроса:
++В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
--{
--
--  "vehicleIds": [ ], ~/~/ Список ID машины
--
-- "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время прихода последнего сообщения
--
--  "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время формирования последнего сообщения
--
--  "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
--
--}
--
--
  Ответ:
    {
      "vehicleId": 0, ~/~/Идентификатор объекта.
@@ -2257,7 +2257,7 @@
      "vehicleNumber": "string",~/~/Номер объекта.
      "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
      "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
--    "state": 0,~/~/Определяет состояния объекта в мониторинге: в движении, остановка, стоянка, отключена, нет данных.
++    "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
      "speed": 0,~/~/Скорость объекта.
      "course": 0,~/~/Курс движения [0;360]
      "latitude": 0,~/~/Широта [-90°;90°].
@@ -4053,6 +4053,152 @@
  |driverName|Имя водителя
  |driverRfid|Номер Карты-метки
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) =
++
++== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==
++
++Транзакции по топливным картам можно получить при наличии права «Транзакции ТК»
++
++(% class="box infomessage" %)
++(((
++**POST**/api/v3/fuelcards/transactions
++)))
++
++Запрос должен содержать параметры:
++
++{
++
++  "startDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата начала периода построения
++
++  "endDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата окончания периода построения
++
++  "ids": [
++
++    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid-ы топливных карт
++
++  ],
++
++  "timezone": 0, ~/~/ Часовой пояс
++
++  "agent": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid клиента владельца
++
++}
++
++Ответ:
++
++  {
++
++    "date": "2024-03-14T13:14:26.212Z", ~/~/ Дата транзакции
++
++    " driver ": "string", ~/~/ Имя водителя
++
++    "amount": 0, ~/~/ Количество топлива
++
++    "amountDut": 0, ~/~/ Количество топлива по ДУТ
++
++    "amountDiff": 0, ~/~/ Разница в литрах
++
++    "amountDiffPerc": 0, ~/~/ Разница в %
++
++    "summa": 0, ~/~/  Стоимость в руб.
++
++    "serviceName": "string", ~/~/ Тип топлива
++
++    "price": 0, ~/~/ Цена за литр в руб.
++
++    "cardName": "string", ~/~/ Наименование ТК
++
++    "cardNum": "string", ~/~/ Номер ТК
++
++    "operator": "string", ~/~/ Оператор ТК
++
++    "address": "string", ~/~/ Адрес АЗС
++
++    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/  Guid топливной карты
++
++  }
++
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
++
++== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
++
++
++(% class="box infomessage" %)
++(((
++GET api/v3/Vehicles/recyclebin/all
++)))
++
++Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
++
++Параметр запроса: {parentId} - идентификатор агента
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++Ответ:
++
++"recordTime": "2024-03-12T12:40:42.502257Z", - Время удаления объекта в UTC
++"userId": "11111111-c384-43f8-8562-1c3d79a32303", - Пользователь удаливший объект
++"parentId": "f649b532-e519-42da-941e-5fdb3b581482", - GUID агента
++"objectId": "8c79a744-0ba6-4943-8d9e-a9d9509168f2", - GUID объекта
++"objectType": "Vehicle", - Тип объекта
++"details": {
++"items": [ {
++"name": "ObjectName", - наименование столбца
++"value": "01" - содержание столбца
++},
++
++{
++"parentName": "string",
++"name": "string",
++"picture": "string",
++"minspeed": 0,
++"maxspeed": 0,
++"width": 0,
++"imbeddedtrailer": true,
++"hoppercapacity": 0,
++"hopperdischargespeed": 0,
++"modelType": 0,
++"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++"deleted": true
++}
++
++(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**
++
++(% class="box infomessage" %)
++(((
++POST/api/v3/Vehicles/recyclebin/erase
++)))
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++Параметры в теле запроса (JSON):
++[
++"eb737fdf-c422-4df7-8727-bd61439b8460",
++"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3"
++]
++
++Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
++
++== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) ==
++
++(% class="box infomessage" %)
++(((
++POST/api/v3/Vehicles/recyclebin/restore
++)))
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++Параметры в теле запроса (JSON):
++[
++"eb737fdf-c422-4df7-8727-bd61439b8460",
++"3ec2f507-dfdc-41d4-b2bb-6f66e3d27df3"
++]
++
++Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
++
++
++
  (% class="box" lang="en-US" style="text-align: center;" %)
  (((
  (% 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]] **

Changes for page Методы API для работы с ГЛОНАССSoft

Summary

Details

Меню