Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Андрей Калиновский 2025/03/28 11:43
<
>
отредактировано Андрей Калиновский
на 2025/02/25 16:35
на 2025/02/25 16:35
отредактировано Андрей Калиновский
на 2025/03/25 13:59
на 2025/03/25 13:59
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -11,6 +11,11 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 +(% class="box infomessage" %) 15 +((( 16 +**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 +\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 +))) 14 14 15 15 **Содержание страницы:** 16 16 ))) ... ... @@ -2512,6 +2512,8 @@ 2512 2512 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2513 2513 "fuelConsumption": 0, ~/~/ Расход топлива 2514 2514 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2520 + "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2521 + 2515 2515 } 2516 2516 ] 2517 2517 } ... ... @@ -2557,7 +2557,8 @@ 2557 2557 "model": "string", ~/~/ Модель объекта 2558 2558 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2559 2559 { 2560 - "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2567 + "event": 0, ~/~/ Тип события 0 - Other, 1 - Engine, 2 - Stop, 3 - FuelIn, 4 - FuelOut, 5 - Garbage, 6 - Grader, 8 - Otval, 9 - Sand, 10 - MixerLand, 11 - MixerMove, 12 - OpenCircuit, 13 - TechSpeed, 14 - Work, 15 - Braid, 16 - Broom, 17 - ReFuller, 18 - Crane, 19 - Power, 20 - TankFuelIn, 21 - TankFuelOut, 22 - BigStop, 23 - OverSpeed, 24 - Unloading, 25 - Warning, 26 - GarbageWork, 27 - Custom, 28 - CustomWork, 29 - GNSS, 30 - GrainIn, 31 - GrainOut, 32 - WeighingTerminal, 33 - Stopping, 34 - FertilizerWork, 35 - FertilizerRefueling 2568 + 2561 2561 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2562 2562 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2563 2563 "valueFuel": 0, ~/~/ Количество ... ... @@ -4878,13 +4878,16 @@ 4878 4878 **POST /api/v3/agroLands** 4879 4879 ))) 4880 4880 4889 +Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 4890 +X-agent - ID клиента 4891 + 4881 4881 Пример запроса: 4882 4882 4883 4883 ((( 4884 4884 { 4885 4885 "extId": "string", 4886 - "shape": " string", ~/~/ Форма поля4887 - "shapeFormat": "s tring", ~/~/ Формат, в котором представлена форма поля4897 + "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 4898 + "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 4888 4888 "display": "string", ~/~/ Настройки отображения 4889 4889 "year": 0, ~/~/ Год поля 4890 4890 "name": "string", ~/~/ Наименование ... ... @@ -5805,6 +5805,128 @@ 5805 5805 ))) 5806 5806 5807 5807 5819 += **Раздел: Локатор ** = 5820 + 5821 + 5822 +== **Получение списка локаторов, доступных пользователю ** == 5823 + 5824 +(% class="box infomessage" %) 5825 +((( 5826 +**GET /api/v3/locators** 5827 +))) 5828 + 5829 +В заголовках запроса: X-Auth: Токен авторизации 5830 + 5831 + 5832 +Пример ответа: 5833 + 5834 +((( 5835 +[ 5836 + { 5837 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5838 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5839 + "agentName": "string", ~/~/ Наименование агента. 5840 + "isEnabled": true, ~/~/ Активен 5841 + "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5842 + "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5843 + "name": "string", ~/~/ Наименование 5844 + "status": 0, ~/~/ 5845 + "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5846 + "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5847 + "validity": 0, ~/~/ Срок действия в днях (1-90). 5848 + "autoProlongation": true, ~/~/ Автопродление срока действия. 5849 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5850 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5851 + "url": "string", ~/~/ Ссылка 5852 + "language": 0, ~/~/ Язык. 5853 + "vehiclesCount": 0, ~/~/ Количество объектов. 5854 + "geozonesCount": 0, ~/~/ Количество геозон. 5855 + "fieldsCount": 0 ~/~/ Количество полей. 5856 + } 5857 +] 5858 +))) 5859 + 5860 + 5861 + 5862 +== **Создание локатора** == 5863 + 5864 +(% class="box successmessage" %) 5865 +((( 5866 +**POST /api/v3/locators** 5867 +))) 5868 + 5869 +Пример запроса: 5870 + 5871 +((( 5872 +{ 5873 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5874 + "isEnabled": true, ~/~/ Активность 5875 + "name": "string", ~/~/ Наименование локатора 5876 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5877 + "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5878 + "validity": 0, ~/~/ Срок действия в днях (1-90) 5879 + "autoProlongation": true, ~/~/ Автопродление срока действия. 5880 + "url": "string", ~/~/ Ссылка 5881 + "language": 0 ~/~/ Язык 5882 +} 5883 +))) 5884 + 5885 + 5886 +Пример ответа: 5887 + 5888 +((( 5889 +3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5890 +))) 5891 + 5892 + 5893 + 5894 +== **Изменение локатора** == 5895 + 5896 +(% class="box infomessage" %) 5897 +((( 5898 +**PUT /api/v3/locators** 5899 +))) 5900 + 5901 +Пример запроса: 5902 + 5903 +((( 5904 +{ 5905 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5906 + "isEnabled": true, ~/~/ Активность 5907 + "name": "string", ~/~/ Наименование 5908 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5909 + "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5910 + "validity": 0, ~/~/ Срок действия в днях (1-90) 5911 + "autoProlongation": true, ~/~/ Автопродление срока действия 5912 + "url": "string", ~/~/ Ссылка 5913 + "language": 0 ~/~/ Язык 5914 +} 5915 +))) 5916 + 5917 + 5918 +Пример ответа: 5919 + 5920 +200 ~/~/ Success 5921 + 5922 + 5923 +== **Удалить локатор** == 5924 + 5925 +(% class="box warningmessage" %) 5926 +((( 5927 +**DELETE /api/v3/locators** 5928 +))) 5929 + 5930 +Пример запроса: 5931 + 5932 +((( 5933 +[ 5934 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 5935 +] 5936 +))) 5937 + 5938 + 5939 + 5940 + 5808 5808 (% class="box" lang="en-US" style="text-align: center;" %) 5809 5809 ((( 5810 5810 (% 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]] **