Last modified by Андрей Калиновский on 2025/01/28 12:59
<
From version < 127.1 >
edited by Илья Крайнов
on 2023/11/29 10:51
To version < 119.1 >
edited by Илья Крайнов
on 2023/11/23 10:14
>
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -356,21 +356,6 @@
356 356  
357 357  Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
358 358  
359 -== (% style="color:#000000; font-size:16px" %)**Смена статуса клиента (активация/блокировка)**(%%) ==
360 -
361 -(% class="box warningmessage" %)
362 -(((
363 -**PUT /api/v3/agents/{id}/changeStatus/{status}**
364 -)))
365 -
366 -Метод позволяет изменить статус клиента, указанного в запросе.
367 -
368 -В пути указывается GUID клиента и статус клиента.
369 -
370 -**status **- значение 0 - заблокирован, 1 - активен.
371 -
372 -Ответ: Code 204
373 -
374 374  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) =
375 375  
376 376  == (% style="color:#000000; font-size:16px" %)**Добавление пользователя**(%%) ==
... ... @@ -1887,51 +1887,6 @@
1887 1887   }
1888 1888  ]
1889 1889  
1890 -== (% style="color:#000000; font-size:16px" %)**Получить тип и номер входа сырого параметра **(%%) ==
1891 -
1892 -(% class="box infomessage" style="text-align: left;" %)
1893 -(((
1894 -**POST /api/v3/terminalMessages/mapping**
1895 -)))
1896 -
1897 -Запрос позволяет узнать тип и номер входа для сырого параметра, приходящего по указанному протоколу.
1898 -
1899 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/mapping
1900 -
1901 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
1902 -
1903 -{
1904 - "protocolType": 0,
1905 - "params": ["string"]
1906 -}
1907 -
1908 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
1909 -|protocolType|ID типа протокола
1910 -|params|(((
1911 -Массив наименований параметров в сообщении
1912 -)))
1913 -
1914 -Ответ:
1915 -
1916 -{
1917 - "protocolType": 0,
1918 - "mapping": {
1919 - "additionalProp1": {
1920 - "inputType": 0,
1921 - "inputNumber": 0
1922 - },
1923 - "additionalProp2": {
1924 - "inputType": 0,
1925 - "inputNumber": 0
1926 - }
1927 - }
1928 -}
1929 -
1930 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
1931 -|protocolType|Тип протокола
1932 -|inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный
1933 -|inputNumber|Номер входа
1934 -
1935 1935  == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) ==
1936 1936  
1937 1937  (% class="box infomessage" %)
... ... @@ -1956,11 +1956,6 @@
1956 1956   "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса
1957 1957  }
1958 1958  
1959 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
1960 -|vehicleId|ID объекта
1961 -|from|Дата и время начала периода запроса
1962 -|to|Дата и время окончания периода запроса
1963 -
1964 1964  Ответ:
1965 1965  
1966 1966  [
... ... @@ -1967,43 +1967,25 @@
1967 1967   {
1968 1968   "messages": [
1969 1969   {
1970 - "deviceTime": "2023-11-29T07:40:44.052Z",
1971 - "serverTime": "2023-11-29T07:40:44.052Z",
1972 - "speed": 0,
1973 - "altitude": 0,
1974 - "latitude": 0,
1975 - "longitude": 0,
1976 - "satellites": 0,
1977 - "course": 0,
1978 - "voltage": 0,
1979 - "parameters": {
1905 + "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства
1906 + "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера
1907 + "speed": 0, ~/~/ Скорость, км/ч
1908 + "altitude": 0, ~/~/ Высота, м
1909 + "latitude": 0, ~/~/ Широта [-90°;90°]
1910 + "longitude": 0, ~/~/ Долгота [-180°;180°]
1911 + "satellites": 0, ~/~/ Кол-во спутников
1912 + "voltage": 0, ~/~/ Напряжение
1913 + "parameters": { ~/~/ список параметров датчиков передаваемых терминалом
1980 1980   "additionalProp1": "string",
1981 1981   "additionalProp2": "string",
1982 1982   "additionalProp3": "string"
1983 1983   },
1984 - "photoCount": 0,
1985 - "lbsCorrectedCoords": true,
1986 - "protocolType": 0
1918 + "photoCount": 0 ~/~/ Кол-во фото
1987 1987   }
1988 1988   ]
1989 1989   }
1990 1990  ]
1991 1991  
1992 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
1993 -|deviceTime|Время сообщения терминала
1994 -|serverTime|Время когда сообщение поступило на сервер
1995 -|speed|Скорость
1996 -|altitude|Высота над уровнем моря
1997 -|latitude|Широта
1998 -|longitude|Долгота
1999 -|satellites|Кол-во спутников
2000 -|course|Курс
2001 -|voltage|Бортовое напряжение
2002 -|parameters|Список параметров и их значений
2003 -|photoCount|Количество фото
2004 -|lbsCorrectedCoords|Признак того, что координаты были скорректированы по LBS, true - скорректированы, false - не скорректированы
2005 -|protocolType|ID типа протокола
2006 -
2007 2007  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) =
2008 2008  
2009 2009  == (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) ==
... ... @@ -3489,8 +3489,6 @@
3489 3489  **PUT /api/v3/Billing/client/balance**
3490 3490  )))
3491 3491  
3492 -Устанавливает указанное значение баланса не создавая операции пополнение/снятие.
3493 -
3494 3494  Тело запроса:
3495 3495  
3496 3496  {
... ... @@ -3504,50 +3504,6 @@
3504 3504  |(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
3505 3505  |(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
3506 3506  
3507 -== (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) ==
3508 -
3509 -(% class="box warningmessage" %)
3510 -(((
3511 -**PUT /api/v3/billing/client/balance/deposit**
3512 -)))
3513 -
3514 -Создает операцию **Пополнение **с указанной суммой
3515 -
3516 -Тело запроса:
3517 -
3518 -{
3519 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3520 - "Balance": 0
3521 -}
3522 -
3523 -Ответ: Success
3524 -
3525 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3526 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
3527 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
3528 -
3529 -== (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) ==
3530 -
3531 -Создает операцию **Списание **с указанной суммой
3532 -
3533 -(% class="box warningmessage" %)
3534 -(((
3535 -**PUT /api/v3/billing/client/balance/withdraw**
3536 -)))
3537 -
3538 -Тело запроса:
3539 -
3540 -{
3541 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3542 - "Balance": 0
3543 -}
3544 -
3545 -Ответ: Success
3546 -
3547 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3548 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
3549 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
3550 -
3551 3551  == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) ==
3552 3552  
3553 3553  (% class="box warningmessage" %)
... ... @@ -3622,11 +3622,6 @@
3622 3622  
3623 3623  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) =
3624 3624  
3625 -(% class="box warningmessage" %)
3626 -(((
3627 -Для тестирования запросов **Импорта **в Postman необходимо скачать его на ПК. Версия в браузере не позволяет загружать файлы в тело запроса.
3628 -)))
3629 -
3630 3630  == (% style="color:#000000; font-size:16px" %)**Импорт объектов**(%%) ==
3631 3631  
3632 3632  (% class="box infomessage" %)
... ... @@ -3634,95 +3634,20 @@
3634 3634  **POST /api/v3/vehicles/import/{agentId}**
3635 3635  )))
3636 3636  
3637 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.**
3503 +**agentId** - id клиента.
3638 3638  
3639 -В пути указывается **agentId** - id клиента.
3640 3640  
3641 -**Заголовок**
3642 -
3643 -**X-Auth: [токен авторизации]**
3644 -
3645 -**Параметры**
3646 -
3647 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3648 -|withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать.
3649 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление
3650 -
3651 -В теле использовать тип **form-data,** тип значения** file**
3652 -
3653 -**Ключи**
3654 -
3655 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3656 -|data|В значении передаем файл объекта, формат **xml** или **wlp **
3657 -|csv|В значении передаем файл датчиков, формат **csv**
3658 -
3659 -Ответ:
3660 -
3661 -{
3662 - "vehicleId": 0,
3663 - "name": "string",
3664 - "errors": ["string"]
3665 -}
3666 -
3667 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3668 -|vehicleId|ID созданного объекта
3669 -|name|Имя созданного объекта
3670 -|errors|Ошибки и их описание
3671 -
3672 3672  == (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) ==
3673 3673  
3674 3674  (% class="box infomessage" %)
3675 3675  (((
3676 -**POST** **/api/v3/vehicles/import/history/{vehicleId}**
3510 +**POST /api/v3/vehicles/import/history/{vehicleId}**
3677 3677  )))
3678 3678  
3679 3679  (% class="wikigeneratedid" %)
3680 -Позволяет импортировать сообщения в выбранный объект. Сообщения должны иметь формат **wln** или **json**. Также они могут быть упакованы и переданы в виде в **zip-архива**.
3514 +**vehicleId **- id объекта.
3681 3681  
3682 -(% class="wikigeneratedid" %)
3683 -В пути указывается **vehicleId **- id объекта.
3684 3684  
3685 -**Заголовок**
3686 -
3687 -**X-Auth: [токен авторизации]**
3688 -
3689 -В теле использовать тип **form-data.**
3690 -
3691 -Ключи:
3692 -
3693 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3694 -|**history**|В значении передавать файл с историей
3695 -
3696 -В случае, если загружается история из файла **wln **можно выполнять подмену названий параметров. В ключе вы указываете название параметра из файла, в значении указываете значение на которое нужно заменить.
3697 -
3698 -Ответ:
3699 -
3700 -{
3701 - "results": [
3702 - {
3703 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3704 - "vehicleId": 0,
3705 - "errors": [
3706 - "string"
3707 - ],
3708 - "firstMessageDate": "2023-11-28T09:27:58.949Z",
3709 - "lastMessageDate": "2023-11-28T09:27:58.949Z",
3710 - "producedCount": 0,
3711 - "msgCount": 0
3712 - }
3713 - ]
3714 -}
3715 -
3716 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3717 -|results|Результаты импорта в разрезе ТС
3718 -|vehicleGuid|Guid ТС
3719 -|vehicleId|ID ТС
3720 -|errors|Список ошибок импорта истории (если пустой - нет ошибок)
3721 -|firstMessageDate|Дата первого импортированного сообщения (UTC)
3722 -|lastMessageDate|Дата последнего импортированного сообщения (UTC)
3723 -|producedCount|Кол-во успешно отправленных в шину данных сообщений
3724 -|msgCount|Кол-во обработанных сообщений всего
3725 -
3726 3726  == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==
3727 3727  
3728 3728  (% class="box infomessage" %)
... ... @@ -3730,20 +3730,7 @@
3730 3730  **GET /api/v3/vehicles/import/history/status**
3731 3731  )))
3732 3732  
3733 -Запрос статуса импорта истории. Может потребоваться в случае импорта истории за большой период.
3734 3734  
3735 -Ответ:
3736 -
3737 -{
3738 - "activity": true,
3739 - "progress": 0,
3740 - "message": "string"
3741 -}
3742 -
3743 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3744 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет
3745 -|progress|Guid ТС
3746 -
3747 3747  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
3748 3748  
3749 3749  (% class="box infomessage" %)

Меню

ГЛОНАССSoft wiki - 2024 г.