Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Павел Субботин on 2025/12/11 11:25
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. subbotinpa1 +XWiki.Gadmin - Content
-
... ... @@ -6,7 +6,7 @@ 6 6 просим вас соблюдать несколько простых правил при использовании API-команд:## 7 7 ))) 8 8 9 -* Формировать не более 2запросавсекунду с кратковременным разрешением до3-х.9 +* Формировать не более 3 отчётов одновременно. 10 10 * Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. ... ... @@ -287,6 +287,28 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 290 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 291 +|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 292 +|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 293 +|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 294 +|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 295 +|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 296 +|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 297 +|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 298 +|(% style="width:215px" %)district|(% style="width:861px" %)Округ 299 +|(% style="width:215px" %)region|(% style="width:861px" %)Регион 300 +|(% style="width:215px" %)city|(% style="width:861px" %)Город 301 +|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 302 +|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 303 +|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 304 +|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 305 +|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 306 +|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 307 +|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 308 +|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 309 +|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 310 +|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 311 + 290 290 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 291 291 292 292 (% class="box warningmessage" %) ... ... @@ -432,7 +432,7 @@ 432 432 [ 433 433 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 434 434 ], 435 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский457 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 436 436 } 437 437 { 438 438 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -744,11 +744,6 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 747 -(% class="wikigeneratedid" id="H" %) 748 -((( 749 - 750 -))) 751 - 752 752 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 753 753 754 754 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -2372,7 +2372,7 @@ 2372 2372 Тело запроса: 2373 2373 2374 2374 { 2375 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2392 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2376 2376 "vehicleIds": [0], ~/~/ Список ID объектов 2377 2377 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2378 2378 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2419,7 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 - "sampling": 86400, ~/~/ Частота дискретизации,секунд, минимум-60(если передано,то весь период бъётсяна подпериоды с указанной частотой)2439 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2423 2423 "vehicleIds": [0], ~/~/ Список ID объектов 2424 2424 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2425 2425 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2569,415 +2569,185 @@ 2569 2569 В заголовках запроса: X-Auth: Токен авторизации 2570 2570 2571 2571 2572 -В массивеуказываемid объектов через запятую2589 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2573 2573 2574 2574 Ответ: 2575 - 2576 -[ 2577 2577 { 2578 - "vehicleId": 55728, ~/~/Идентификатор объекта2579 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",~/~/Guidобъекта2580 - "vehicleNumber": " 0105 КМ",~/~/Номер объекта2581 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",~/~/Время идатапоступления данных2582 - "recordTime": "202 5-06-27T12:37:19Z",~/~/Время идатаформированиеданных2583 - "state": 4,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.2584 - "speed": 31,~/~/Скорость объекта2585 - "course": 116,~/~/Курс движения [0;360]2586 - "latitude": 45.722128,~/~/Широта [-90°;90°].2587 - "longitude": 39.800432,~/~/Долгота [-180°;180°].2588 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/Адрес2589 - "geozones": [ ~/~/ Сведения по геозонам.2593 + "vehicleId": 0, ~/~/Идентификатор объекта. 2594 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2595 + "vehicleNumber": "string",~/~/Номер объекта. 2596 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2597 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2598 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2599 + "speed": 0,~/~/Скорость объекта. 2600 + "course": 0,~/~/Курс движения [0;360] 2601 + "latitude": 0,~/~/Широта [-90°;90°]. 2602 + "longitude": 0,~/~/Долгота [-180°;180°]. 2603 + "address": "string",~/~/Адрес. 2604 + "geozones": [ ~/~/Сведения по геозонам. 2590 2590 { 2591 - "id": 10225647, ~/~/ ID Геозоны 2592 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2593 - }, 2594 - { 2595 - "id": 10282875, ~/~/ ID Геозоны 2596 - "name": "Ё2" ~/~/ Наименование геозоны 2597 - }, 2598 - { 2599 - "id": 10226240, ~/~/ ID Геозоны 2600 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2601 - }, 2602 - { 2603 - "id": 9747869, ~/~/ ID Геозоны 2604 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2605 - }, 2606 - { 2607 - "id": 10221123, ~/~/ ID Геозоны 2608 - "name": "53r" ~/~/ Наименование геозоны 2609 - }, 2610 - { 2611 - "id": 10197638, ~/~/ ID Геозоны 2612 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2606 + "id": 0, 2607 + "name": "string" 2613 2613 } 2614 - ] 2615 - } 2616 2616 2617 2617 2618 2618 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2619 2619 2620 -== (% style="color:#000000; font-size:16px" %)**Получение и нформацииогеозонепоID геозоны**(%%) ==2613 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2621 2621 2622 2622 (% class="box infomessage" %) 2623 2623 ((( 2624 -** GET/api/v3/gis/{geozoneId}**2617 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2625 2625 ))) 2626 2626 2627 -Пример запроса: 2628 -\\geozoneId ~/~/ id геозоны 2620 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2629 2629 2622 +(% style="color:#000000" %)Метод запроса: **POST** 2630 2630 2631 -(% style="text-align:left" %) 2632 -Ответ: 2624 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2633 2633 2634 -((( 2635 -{ 2636 - "id": 0, ~/~/ Идентификатор объекта геозоны 2637 - "name": "string", ~/~/ Наименование объекта геозоны 2638 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2639 - "description": "string", ~/~/ Описание объекта геозоны 2640 - "beginCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата начала расчетов для геозоны 2641 - "endCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата окончания расчетов для геозоны 2642 - "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2643 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2644 - "radius": 0, ~/~/ Радиус геозоны 2645 - "shape": "string", ~/~/ Координаты геозоны 2646 - "shape_format": "string" ~/~/ Формат xml,json 2647 -} 2648 -))) 2626 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2649 2649 2650 -((( 2651 - 2652 -))) 2628 +(% style="text-align:left" %) 2629 +Тело запроса: 2653 2653 2654 -== **Удаление геообъекта ** == 2655 - 2656 -((( 2657 - 2658 -))) 2659 - 2660 -(% class="box errormessage" %) 2661 -((( 2662 -**DELETE /api/v3/gis/{geozoneId}** 2663 -))) 2664 - 2665 -((( 2666 -Пример запроса: 2667 -))) 2668 - 2669 -((( 2670 - 2671 -))) 2672 - 2673 -((( 2674 -geozoneId ~/~/ Id геообъекта 2675 -))) 2676 - 2677 -((( 2678 - 2679 -))) 2680 - 2681 -((( 2682 -Пример ответа: 2683 -))) 2684 - 2685 -((( 2686 - 2687 -))) 2688 - 2689 -((( 2690 -200 ~/~/ Success 2691 -))) 2692 - 2693 -((( 2694 - 2695 -))) 2696 - 2697 -== **Возвращение данных по пересечению объектами геозон ** == 2698 - 2699 -((( 2700 - 2701 -))) 2702 - 2703 -(% class="box successmessage" %) 2704 -((( 2705 -**POST /api/v3/gis/intersections/geozones** 2706 -))) 2707 - 2708 -((( 2709 -Пример запроса: 2710 -))) 2711 - 2712 -((( 2713 -((( 2631 +(% style="text-align:left" %) 2714 2714 { 2715 - "startDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время начала расчета 2716 - "endDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время конца расчета 2717 - "ids": [ ~/~/ Идентификаторы объектов 2718 - 0 2719 - ], 2720 - "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2721 - "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2722 - "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2723 - "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2724 - "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2633 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2725 2725 } 2726 -))) 2727 -))) 2728 2728 2729 -((( 2730 - 2731 -))) 2636 +(% style="text-align:left" %) 2637 +Ответ: 2732 2732 2733 -((( 2734 -Пример ответа: 2735 -))) 2736 - 2737 -((( 2738 -((( 2739 2739 [ 2740 2740 { 2741 - "geozoneId": 0, ~/~/ ID геозоны 2742 - "geozoneName": "string", ~/~/ Наименование геозоны 2743 - "startDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время входа из геозоны 2744 - "endDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время выхода из геозоны 2745 - "duration": 0, ~/~/ Продолжительность внутри геозоны 2746 - "vehicleId": 0, ~/~/ ID объекта 2747 - "vehicleName": "string", ~/~/ Имя объекта 2748 - "motoHours": 0 ~/~/ Моточасы 2641 + "id": 0, ~/~/ Идентификатор объекта геозоны 2642 + "name": "string", ~/~/ Название объекта геозоны 2643 + "type": 0, ~/~/ Тип объекта геозоны 2644 + "fname": "string", ~/~/ Имя файла 2645 + "parentId": "string", ~/~/ Идентификатор клиента 2646 + "radius": 0, ~/~/ Радиус геообъекта 2647 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2648 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2649 + "description": "string", ~/~/ Описание 2650 + "area": 0, ~/~/ Площадь, м^^2^^ 2651 + "perimetr": 0, ~/~/ Периметр, м 2652 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2749 2749 } 2750 2750 ] 2751 -))) 2752 -))) 2753 2753 2656 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2657 + 2658 +(% class="box infomessage" %) 2754 2754 ((( 2755 - 2660 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2756 2756 ))) 2757 2757 2758 -= =**Возвращениеданныхпо пересечениюгеозондляобъектов с заданнымиID ** ==2663 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2759 2759 2760 -((( 2761 - 2762 -))) 2665 +(% style="color:#000000" %)Метод запроса: **POST** 2763 2763 2764 -(% class="box successmessage" %) 2765 -((( 2766 -**POST /api/v3/gis/intersections/vehicles** 2767 -))) 2667 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2768 2768 2769 -((( 2770 -Пример запроса: 2771 -))) 2669 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2772 2772 2773 -((( 2774 - 2775 -))) 2671 +(% style="text-align:left" %) 2672 +Тело запроса: 2776 2776 2777 -((( 2778 -((( 2779 2779 { 2780 - "startDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время начала расчета 2781 - "endDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время конца расчета 2782 - "ids": [ ~/~/ Идентификаторы объектов 2783 - 0 2784 - ], 2785 - "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2786 - "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2787 - "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2788 - "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2789 - "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2675 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2676 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2677 + "ids": [ ], ~/~/ Массив id объектов 2678 + "byTime": 0, ~/~/ Объединение событий по времени 2679 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2680 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2681 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2790 2790 } 2791 -))) 2792 -))) 2793 2793 2794 -((( 2795 - 2796 -))) 2797 - 2798 -((( 2799 -Пример ответа: 2800 -))) 2801 - 2802 -((( 2684 +Ответ: 2803 2803 [ 2804 2804 { 2805 - "geozoneId": 0, ~/~/ ID гео зоны2806 - "geozoneName": "string", ~/~/ Наименование геозоны2807 - "startDate": "202 5-12-04T07:19:27.629Z", ~/~/Датуивремя входаиз геозоны2808 - "endDate": "202 5-12-04T07:19:27.629Z", ~/~/Датуивремя выхода из геозоны2809 - "duration": 0, ~/~/ Продолжительностьвнутри геозоны2687 + "geozoneId": 0, ~/~/ ID геообъекта 2688 + "geozoneName": "string", ~/~/ Название геообъекта 2689 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2690 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2691 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2810 2810 "vehicleId": 0, ~/~/ ID объекта 2811 - "vehicleName": "string", ~/~/ Имя объекта 2812 - "motoHours": 0 ~/~/ Моточасы 2693 + "vehicleName": "string" ~/~/ Имя объекта 2813 2813 } 2814 2814 ] 2815 -))) 2816 2816 2697 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2698 + 2699 +(% class="box infomessage" %) 2817 2817 ((( 2818 - 2701 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2819 2819 ))) 2820 2820 2821 -= =**Получениесписка геозон**==2704 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2822 2822 2823 -((( 2824 - 2825 -))) 2706 +(% style="color:#000000" %)Метод запроса: **POST** 2826 2826 2827 -(% class="box successmessage" %) 2828 -((( 2829 -**POST /api/v3/gis/find** 2830 -))) 2708 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2831 2831 2832 -((( 2833 -((( 2834 -Пример запроса: 2835 -))) 2710 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2836 2836 2837 -((( 2838 - 2839 -))) 2712 +(% style="text-align:left" %) 2713 +Тело запроса: 2840 2840 2841 -((( 2842 2842 { 2843 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента, для которого надо получить данные. 2716 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2717 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2718 + "ids": [ ], ~/~/ Массив id геообъектов 2719 + "byTime": 0, ~/~/ Объединение событий по времени 2720 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2721 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2722 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2844 2844 } 2845 -))) 2846 -))) 2847 2847 2848 -((( 2849 - 2850 -))) 2725 +Ответ: 2851 2851 2852 -((( 2853 -Пример ответа: 2854 -))) 2855 - 2856 -((( 2857 -((( 2858 2858 [ 2859 2859 { 2860 - "id": 0, ~/~/ Идентификатор объекта геозоны 2861 - "name": "string", ~/~/ Название объекта геозоны 2862 - "type": 0, ~/~/ Тип объекта геозоны 2863 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2864 - "fname": "string", ~/~/ Имя файла 2865 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2866 - "beginCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата начала расчетов для геозоны 2867 - "endCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата окончания расчетов для геозоны 2868 - "description": "string", ~/~/ Описание объекта геозоны 2869 - "area": 0, ~/~/ Площадь, м2 2870 - "perimetr": 0, ~/~/ Периметр, м 2871 - "createDate": "2025-12-04T07:31:23.082Z" ~/~/ Дата создания в бд 2729 + "geozoneId": 0, ~/~/ ID геообъекта 2730 + "geozoneName": "string", ~/~/ Название геообъекта 2731 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2732 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2733 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2734 + "vehicleId": 0, ~/~/ ID объекта 2735 + "vehicleName": "string" ~/~/ Имя объекта 2872 2872 } 2873 2873 ] 2874 -))) 2875 -))) 2876 2876 2877 -((( 2878 - 2879 -))) 2880 2880 2881 -== ** Созданиегеообъекта** ==2740 +== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2882 2882 2883 -((( 2884 - 2885 -))) 2886 - 2887 2887 (% class="box successmessage" %) 2888 2888 ((( 2889 -** POST/api/v3/gis**2744 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2890 2890 ))) 2891 2891 2892 -( ((2893 - (((2747 +(% style="color:#000000" %)Метод запроса: **PUT** 2748 + 2894 2894 Пример запроса: 2895 -\\{ 2896 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2897 - "name": "string", ~/~/ Наименование объекта геозоны 2898 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2899 - "description": "string", ~/~/ Описание объекта геозоны 2900 - "beginCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата начала расчетов для геозоны 2901 - "endCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата окончания расчетов для геозоны 2902 - "settingsData": "string", ~/~/ Параметры отображения в формате XML 2903 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2904 - "radius": 0, ~/~/ Радиус геозоны 2905 - "shape": "string", ~/~/ Координаты геозоны 2906 - "shape_format": "string" ~/~/ Формат xml,json, 2907 -} 2908 -))) 2909 -))) 2910 2910 2911 2911 ((( 2912 - 2913 -))) 2914 - 2915 -((( 2916 -Пример ответа: 2917 -))) 2918 - 2919 -((( 2920 - 2921 -))) 2922 - 2923 -((( 2924 -200 ~/~/ Success 2925 -))) 2926 - 2927 -((( 2928 - 2929 -))) 2930 - 2931 -== **Редактирование геообъекта ** == 2932 - 2933 -((( 2934 - 2935 -))) 2936 - 2937 -(% class="box warningmessage" %) 2938 -((( 2939 -**PUT /api/v3/gis** 2940 -))) 2941 - 2942 -((( 2943 -((( 2944 -Пример запроса: 2945 2945 { 2946 - "id": 0, ~/~/ Идентификатор объекта геозоны 2947 - "name": "string", ~/~/ Наименование объекта геозоны 2948 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2949 - "description": "string", ~/~/ Описание объекта геозоны 2950 - "beginCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата начала расчетов для геозоны 2951 - "endCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата окончания расчетов для геозоны 2952 - "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2953 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2954 - "radius": 0, ~/~/ Радиус геозоны 2955 - "shape": "string", ~/~/ Координаты геозоны 2956 - "shape_format": "string" ~/~/Формат xml,json 2753 + "id": 0, ~/~/ Идентификатор объекта геозоны 2754 + "name": "string", ~/~/ Наименование объекта геозоны 2755 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2756 + "description": "string", ~/~/ Описание объекта геозоны 2757 + "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2758 + "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2759 + "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2957 2957 } 2958 2958 ))) 2959 -))) 2960 2960 2961 -((( 2962 - 2963 -))) 2964 2964 2965 -((( 2966 -Пример ответа: 2967 -))) 2764 +Пример ответа: 2968 2968 2969 -((( 2970 - 2971 -))) 2972 - 2973 -((( 2974 2974 200 ~/~/ Success 2975 -))) 2976 2976 2977 -((( 2978 - 2979 -))) 2980 - 2981 2981 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2982 2982 2983 2983 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -3097,6 +3097,10 @@ 3097 3097 3098 3098 ))) 3099 3099 2887 +((( 2888 + 2889 +))) 2890 + 3100 3100 Ответ: 3101 3101 3102 3102 { ... ... @@ -4378,12 +4378,16 @@ 4378 4378 Тело запроса: 4379 4379 4380 4380 { 4381 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4382 - "Balance": 0 ~/~/ Значение баланса.4172 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4173 + "Balance": 0 4383 4383 } 4384 4384 4385 4385 Ответ: Success 4386 4386 4178 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4179 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4180 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4181 + 4387 4387 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4388 4388 4389 4389 (% class="box warningmessage" %) ... ... @@ -4395,29 +4395,16 @@ 4395 4395 4396 4396 Тело запроса: 4397 4397 4398 -((( 4399 4399 { 4400 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4401 - "a mount": 0~/~/ Сумма пополнения баланса4194 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4195 + "Balance": 0 4402 4402 } 4403 -))) 4404 4404 4405 -((( 4406 - 4407 -))) 4408 - 4409 4409 Ответ: Success 4410 4410 4411 -((( 4412 -{ 4413 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4414 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4415 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4416 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4417 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4418 - "Description": "string" ~/~/ Описание корректировки. 4419 -} 4420 -))) 4200 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4201 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4202 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4421 4421 4422 4422 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4423 4423 ... ... @@ -4430,25 +4430,16 @@ 4430 4430 4431 4431 Тело запроса: 4432 4432 4433 -((( 4434 4434 { 4435 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4436 - "a mount": 0~/~/ Сумма списания с баланса4216 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4217 + "Balance": 0 4437 4437 } 4438 -))) 4439 4439 4440 4440 Ответ: Success 4441 4441 4442 -((( 4443 -{ 4444 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4445 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4446 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4447 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4448 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4449 - "Description": "string" ~/~/ Описание корректировки 4450 -} 4451 -))) 4222 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4223 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4224 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4452 4452 4453 4453 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4454 4454 ... ... @@ -4459,35 +4459,28 @@ 4459 4459 4460 4460 Тело запроса: 4461 4461 4462 -((( 4463 4463 { 4464 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4465 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4466 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4467 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4468 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4469 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4236 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4237 + "CalculationType": 0, 4238 + "PermissibleBalance": 0, 4239 + "DefermentDays": 0, 4240 + "SendUiNotifications": true, 4241 + "SendEmailNotifications": true, 4242 + "IsPrivate": true, 4470 4470 } 4471 -))) 4472 4472 4473 -((( 4474 - 4475 -))) 4476 - 4477 4477 Ответ: Success 4478 4478 4479 -((( 4480 -{ 4481 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4482 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4483 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4484 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4485 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4486 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4487 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4488 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4489 -} 4247 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4248 +|ClientId|Идентификатор клиента 4249 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4250 +|PermissibleBalance|Допустимый баланс 4251 +|DefermentDays|((( 4252 +Отсрочка, количество дней 4490 4490 ))) 4254 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4255 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4256 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4491 4491 4492 4492 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4493 4493 ... ... @@ -4499,68 +4499,35 @@ 4499 4499 Тело запроса: 4500 4500 4501 4501 { 4502 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4503 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4504 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4268 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4269 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4270 + "Features": [ 4505 4505 { 4506 - "Feature": "string", ~/~/ Код услуги.4507 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4508 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4509 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4510 - "Price": 0, ~/~/ Цена за единицу.4511 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4512 - "PeriodValue": 0, ~/~/ Значение периода.4513 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)4272 + "Feature": "string", 4273 + "IsEnabled": true, 4274 + "IsFactual": true, 4275 + "Limit": 0, 4276 + "Price": 0, 4277 + "DebitDate": "2023-10-18T13:26:58.987Z", 4278 + "PeriodValue": 0, 4279 + "PeriodType": 0 4514 4514 } 4515 4515 ] 4516 4516 } 4517 4517 4518 - 4519 4519 Ответ: Success 4520 4520 4521 -((( 4522 -{ 4523 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4524 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4525 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4526 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4527 - "Name": "string", ~/~/ Наименование. 4528 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4529 - "Constraint": { ~/~/ Ограничения по тарифу 4530 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4531 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4532 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4533 - }, 4534 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4535 - { 4536 - "Feature": "string", ~/~/Код услуги. 4537 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4538 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4539 - "Price": 0, ~/~/ Цена за единицу. 4540 - "PeriodValue": 0, ~/~/ Значение периода. 4541 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4542 - } 4543 - ], 4544 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4545 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4546 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4547 - }, 4548 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4549 - { 4550 - "Feature": "string", ~/~/ Код услуги. 4551 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4552 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4553 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4554 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4555 - "Price": 0, ~/~/ Цена за единицу. 4556 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4557 - "PeriodValue": 0, ~/~/ Значение периода. 4558 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4559 - "Quantity": 0 ~/~/ Количество использования услуги. 4560 - } 4561 - ] 4562 -} 4563 -))) 4286 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4287 +|ClientId|Идентификатор клиента 4288 +|PlanId|Идентификатор тарифного плана 4289 +|Feature|Код услуги 4290 +|IsEnabled|Признак, определяющий активирована ли услуга 4291 +|IsFactual|Признак, определяющий расчёт по факту 4292 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4293 +|Price|Цена за единицу. 4294 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4295 +|PeriodValue|Значение периода. 4296 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4564 4564 4565 4565 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4566 4566 ... ... @@ -5633,9 +5633,33 @@ 5633 5633 ))) 5634 5634 5635 5635 5369 +== **Удаление существующего поля** == 5370 + 5371 +(% class="box errormessage" %) 5636 5636 ((( 5373 +**DELETE /api/v3/agroLands/{id}** 5374 +))) 5375 + 5376 +Пример запроса: 5377 +id ~/~/ Идентификатор поля 5378 + 5379 +Пример ответа: 5380 + 5637 5637 ((( 5382 +200 ~/~/ Успех 5383 +))) 5384 + 5638 5638 ((( 5386 + 5387 +))) 5388 + 5389 +((( 5390 +((( 5391 +((( 5392 + 5393 +))) 5394 + 5395 +((( 5639 5639 == **Изменение поля** == 5640 5640 5641 5641 (% class="box infomessage" %) ... ... @@ -5881,102 +5881,9 @@ 5881 5881 "perimetr": 0, ~/~/ ериметр, м 5882 5882 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5883 5883 } 5884 - 5885 - 5886 -== **Какие поля посещал объект** == 5887 - 5888 -(% class="box successmessage" %) 5889 -((( 5890 -**POST /api/v3/agroLands/visitingByVehicle** 5891 5891 ))) 5892 5892 5893 -Пример запроса: 5894 5894 5895 -{ 5896 - "vehicleId": 0, ~/~/ id объекта 5897 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5898 - "byTime": 0, ~/~/ Объединение событий по времени 5899 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5900 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5901 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5902 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5903 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5904 -} 5905 - 5906 -Пример ответа: 5907 - 5908 -[ 5909 - { 5910 - "fieldId": 0, ~/~/ id объекта 5911 - "vehicleName": "string", ~/~/ Наименование объекта 5912 - "fieldName": "string", ~/~/ Наименование поля 5913 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5914 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5915 - "vehicleId": 0, ~/~/ Идентификатор ТС 5916 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5917 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5918 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5919 - "mileage": 0 ~/~/ Пробег 5920 - } 5921 -] 5922 -))) 5923 - 5924 - 5925 -== **Посещение поля объектами ** == 5926 - 5927 -(% class="box successmessage" %) 5928 -((( 5929 -**POST /api/v3/agroLands/visitingByField** 5930 -))) 5931 - 5932 -Пример запроса: 5933 -{ 5934 - "fieldId": 0, ~/~/ ID поля 5935 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5936 - "byTime": 0, ~/~/ Объединение событий по времени 5937 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5938 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5939 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5940 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5941 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5942 -} 5943 - 5944 -Пример ответа: 5945 - 5946 -[ 5947 - { 5948 - "fieldId": 0, ~/~/ ID поля 5949 - "vehicleName": "string", ~/~/ Наименование объекта 5950 - "fieldName": "string", ~/~/ Имя поля 5951 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5952 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5953 - "vehicleId": 0, ~/~/ Идентификатор ТС 5954 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5955 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5956 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5957 - "mileage": 0 ~/~/ Пробег 5958 - } 5959 -] 5960 - 5961 - 5962 -== **Удаление существующего поля** == 5963 - 5964 -(% class="box errormessage" %) 5965 -((( 5966 -**DELETE /api/v3/agroLands/{id}** 5967 -))) 5968 - 5969 -Пример запроса: 5970 -id ~/~/ Идентификатор поля 5971 - 5972 -Пример ответа: 5973 - 5974 -((( 5975 -200 ~/~/ Успех 5976 - 5977 - 5978 -))) 5979 - 5980 5980 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5981 5981 ))) 5982 5982 ))) ... ... @@ -6079,6 +6079,7 @@ 6079 6079 6080 6080 В заголовках запроса: X-Auth: Токен авторизации 6081 6081 5746 + 6082 6082 Пример запроса: 6083 6083 6084 6084 ((( ... ... @@ -6165,6 +6165,7 @@ 6165 6165 } 6166 6166 ))) 6167 6167 5833 + 6168 6168 Пример ответа: 6169 6169 6170 6170 { ... ... @@ -6295,9 +6295,11 @@ 6295 6295 ))) 6296 6296 6297 6297 ((( 6298 - Примерответа:5964 + 6299 6299 ))) 6300 6300 5967 +Пример ответа: 5968 + 6301 6301 { 6302 6302 "vehicleId": 0, ~/~/ Идентификатор ТС 6303 6303 "description": "string", ~/~/ Описание ... ... @@ -6449,30 +6449,35 @@ 6449 6449 6450 6450 ))) 6451 6451 6120 +((( 6121 + 6122 +))) 6123 + 6452 6452 = **Раздел: Локатор ** = 6453 6453 6454 6454 6455 -== **Получение данных полокатору** ==6127 +== **Получение списка локаторов, доступных пользователю ** == 6456 6456 6457 6457 (% class="box infomessage" %) 6458 6458 ((( 6459 -**GET /api/v3/locators /{locatorId}**6131 +**GET /api/v3/locators ** 6460 6460 ))) 6461 6461 6462 -В за просе указываетсяlocatorid- идентификаторлокатора6134 +В заголовках запроса: X-Auth: Токен авторизации 6463 6463 6136 + 6464 6464 Пример ответа: 6465 6465 6466 6466 ((( 6467 6467 ((( 6468 6468 { 6469 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую6142 + "vehiclesIds": [ ~/~/ Объекты 6470 6470 0 6471 6471 ], 6472 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6145 + "geoIds": [ ~/~/ Геозоны 6473 6473 0 6474 6474 ], 6475 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6148 + "fieldsIds": [ ~/~/ Поля 6476 6476 0 6477 6477 ], 6478 6478 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. ... ... @@ -6491,17 +6491,14 @@ 6491 6491 "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6492 6492 "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6493 6493 "url": "string", ~/~/ Ссылка 6494 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6495 - 6496 - "showVehicleName": true, ~/~/ Наименование объекта 6497 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6498 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6499 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6500 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6501 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6502 - 6503 - 1 6504 - 6167 + "language": 0, ~/~/ Язык 6168 + "showVehicleName": true, ~/~/ Наименование объекта 6169 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6170 + "allowTrackReport": true, ~/~/ Трек 6171 + "showTrackTracing": true, ~/~/ Трассировка трека 6172 + "showSensors": true, ~/~/ Датчик 6173 + "availableMapLayers": [ ~/~/ Слои на карте 6174 + 0 6505 6505 ] 6506 6506 } 6507 6507 ))) ... ... @@ -6508,60 +6508,47 @@ 6508 6508 ))) 6509 6509 6510 6510 6511 -== ** Созданиелокатора** ==6181 +== **Получение перечня моделей ** == 6512 6512 6513 6513 (% class="box successmessage" %) 6514 6514 ((( 6515 -**POST /api/v3/ locators**6185 +**POST /api/v3/models/find** 6516 6516 ))) 6517 6517 6518 6518 Пример запроса: 6519 6519 6520 6520 ((( 6191 +((( 6521 6521 { 6522 - "isEnabled": true, ~/~/ Активность 6523 - "name": "string", ~/~/ Наименование локатора 6524 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6525 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6526 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6527 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6528 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6529 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6530 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6531 - 0 6532 - ], 6533 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6534 - 0 6535 - ], 6536 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6537 - 0 6538 - ], 6193 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6194 + "name": "string", ~/~/ Наименование локатора 6195 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6196 +))) 6539 6539 6540 - "showVehicleName": true, ~/~/ Наименование объекта 6541 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6542 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6543 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6544 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6545 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6546 6546 6547 - 1 6548 6548 6549 - ] 6550 -} 6551 -))) 6200 + Пример ответа: 6201 + 6552 6552 6553 -Пример ответа: 6554 - 6555 6555 ((( 6556 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6204 +[ 6205 + { 6206 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6207 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6208 + "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6209 + "name": "string", ~/~/ Наименование локатора 6210 + "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6211 + } 6212 +] 6557 6557 ))) 6214 +))) 6558 6558 6559 6559 6560 -== ** Выводитсписоклокаторов** ==6217 +== **Создание локатора** == 6561 6561 6562 6562 (% class="box successmessage" %) 6563 6563 ((( 6564 -**POST /api/v3/locators /find**6221 +**POST /api/v3/locators** 6565 6565 ))) 6566 6566 6567 6567 Пример запроса: ... ... @@ -6568,53 +6568,45 @@ 6568 6568 6569 6569 ((( 6570 6570 { 6571 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6228 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6229 + "isEnabled": true, ~/~/ Активность 6230 + "name": "string", ~/~/ Наименование локатора 6231 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6232 + "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6233 + "validity": 0, ~/~/ Срок действия в днях (1-90) 6234 + "autoProlongation": true, ~/~/ Автопродление срока действия. 6235 + "url": "string", ~/~/ Ссылка 6236 + "language": 0 ~/~/ Язык 6237 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6238 + "vehiclesIds": [ ~/~/ Oбъекты 6239 + 0 6240 + ], 6241 + "geoIds": [ ~/~/ Геозоны 6242 + 0 6243 + ], 6244 + "fieldsIds": [ ~/~/ Поля 6245 + 0 6246 + ], 6247 + "showVehicleName": true, ~/~/ Наименование объекта 6248 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6249 + "allowTrackReport": true, ~/~/ Трек 6250 + "showTrackTracing": true, ~/~/ Трассировка трека 6251 + "showSensors": true, ~/~/ Датчик 6252 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6253 + 0 6254 + ] 6572 6572 } 6573 6573 ))) 6574 6574 6575 -((( 6576 - 6577 -))) 6578 6578 6579 6579 Пример ответа: 6580 6580 6581 6581 ((( 6582 -[ 6583 - { 6584 - "vehiclesCount": 0, ~/~/ Количество объектов. 6585 - "geozonesCount": 0, ~/~/ Количество геозон. 6586 - "fieldsCount": 0, ~/~/ Количество полей. 6587 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6588 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6589 - "agentName": "string", ~/~/ Наименование агента. 6590 - "isEnabled": true, ~/~/ Активность локатора 6591 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6592 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6593 - "name": "string", ~/~/ Наименование локатора 6594 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6595 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6596 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6597 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6598 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6599 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6600 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6601 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6602 - "url": "string", ~/~/ ссылка на локатор 6603 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6604 - "showVehicleName": true, ~/~/ Наименование объекта 6605 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6606 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6607 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6608 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6609 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6610 - 6611 - 0 6612 - ] 6613 - } 6614 -] 6262 +3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6615 6615 ))) 6616 6616 6617 6617 6266 + 6618 6618 == **Изменение локатора** == 6619 6619 6620 6620 (% class="box infomessage" %) ... ... @@ -6633,25 +6633,25 @@ 6633 6633 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6634 6634 "validity": 0, ~/~/ Срок действия в днях (1-90) 6635 6635 "autoProlongation": true, ~/~/ Автопродление срока действия 6636 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6637 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6285 + "url": "string", ~/~/ Ссылка 6286 + "language": 0 ~/~/ Язык 6287 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6288 + "vehiclesIds": [ ~/~/ Oбъекты 6638 6638 0 6639 6639 ], 6640 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6291 + "geoIds": [ ~/~/ Геозоны 6641 6641 0 6642 6642 ], 6643 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6294 + "fieldsIds": [ ~/~/ Поля 6644 6644 0 6645 6645 ], 6646 6646 "showVehicleName": true, ~/~/ Наименование объекта 6647 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6648 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6649 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6650 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6651 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6652 - 6298 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6299 + "allowTrackReport": true, ~/~/ Трек 6300 + "showTrackTracing": true, ~/~/ Трассировка трека 6301 + "showSensors": true, ~/~/ Датчик 6302 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6653 6653 0 6654 - 6655 6655 ] 6656 6656 } 6657 6657 ... ... @@ -6679,15 +6679,216 @@ 6679 6679 ))) 6680 6680 6681 6681 6682 -= = 6683 6683 6332 += **Раздел: Яндекс Маршруты** = 6333 + 6334 + 6335 +== **Возвращение списка маршрутов** == 6336 + 6337 +(% class="box infomessage" %) 6684 6684 ((( 6339 +**GET /api/v3/TransportRoutes** 6340 +))) 6341 + 6342 +Пример запроса: 6343 +Id ~/~/ Идентификатор поля 6344 + 6345 + 6346 +Пример ответа: 6347 + 6685 6685 ((( 6349 +[ 6350 + { 6351 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6352 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6353 + "name": "string", ~/~/ Наименование маршрута. 6354 + "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6355 + "vehicles": [ ~/~/ Определяет список ТС для маршрута 6356 + 0 6357 + ] 6358 + } 6359 +] 6360 +))) 6361 + 6362 + 6363 + 6364 +== **Добавить маршрут** == 6365 + 6366 +(% class="box infomessage" %) 6367 +((( 6368 +**POST /api/v3/TransportRoutes** 6369 +))) 6370 + 6371 +Пример запроса: 6372 +{ 6373 + "name": "string", ~/~/ Опредлеляет наименование маршрута. 6374 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6375 + "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6376 + "vehicles": [ ~/~/ Определяет список ТС для маршрута 6377 + 0 6378 + ] 6379 +} 6380 + 6381 + 6382 +Пример ответа: 6383 + 6384 +((( 6385 +{ 6386 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6387 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6388 + "name": "string", ~/~/ Определяет наименование маршрута 6389 + "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6390 + "vehicles": [ ~/~/ Определяет список ТС для маршрута 6391 + 0 6392 + ] 6393 +} 6394 +))) 6395 + 6396 + 6397 +== **Обновление маршрута** == 6398 + 6399 +(% class="box successmessage" %) 6400 +((( 6401 +**PUT /api/v3/TransportRoutes** 6402 +))) 6403 + 6404 +Пример запроса: 6405 + 6406 +((( 6407 +{ 6408 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6409 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6410 + "name": "string", ~/~/ Опредлеляет наименование маршрута. 6411 + "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6412 + "vehicles": [ ~/~/ Определяет список ТС для маршрута 6413 + 0 6414 + ] 6415 +} 6416 +))) 6417 + 6418 + 6419 +Пример ответа: 6420 + 6421 +((( 6422 +{ 6423 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6424 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6425 + "name": "string", ~/~/ Определяет наименование маршрута 6426 + "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6427 + "vehicles": [ ~/~/ Определяет список ТС для маршрута 6428 + 0 6429 + ] 6430 +} 6431 +))) 6432 + 6433 + 6434 +== **Получить связки маршрутов ТС** == 6435 + 6436 +(% class="box infomessage" %) 6437 +((( 6438 +**POST /api/v3/TransportRoutes/getroutesvehicles** 6439 +))) 6440 + 6441 +Пример запроса: 6442 + 6443 +((( 6444 +[ 6445 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6446 +] 6447 +))) 6448 + 6449 + 6450 +Пример ответа: 6451 + 6452 +((( 6453 +[ 6454 + { 6455 + "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6456 + "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6457 + } 6458 +] 6459 +))) 6460 + 6461 + 6462 +== **Удалить маршрут** == 6463 + 6464 +(% class="box warningmessage" %) 6465 +((( 6466 +**DELETE /api/v3/TransportRoutes/{id}** 6467 +))) 6468 + 6469 +Пример запроса: 6470 +Id ~/~/ Идентификатор поля 6471 + 6472 + 6473 + 6474 += **Раздел: Управление доступа к машинам** = 6475 + 6476 + 6477 +== Получение списка транспортных средств видимых пользователю == 6478 + 6479 +(% class="box infomessage" %) 6480 +((( 6481 +**GET /api/v3/UserVisibleVehicles/{userId}** 6482 +))) 6483 + 6484 +Пример ответа: 6485 + 6486 +((( 6487 +{ 6488 + "vehicleIds": [ ~/~/ Идентификаторы ТС 6489 + 0 6490 + ] 6491 +} 6492 +))) 6493 + 6494 + 6495 + 6496 +== Задает видимость транспортных средств пользователю == 6497 + 6498 +(% class="box infomessage" %) 6499 +((( 6500 +**POST /api/v3/UserVisibleVehicles** 6501 +))) 6502 + 6503 +Пример запроса: 6504 + 6505 +((( 6506 +((( 6507 +{ 6508 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6509 + "vehicleIds": [ ~/~/ Идентификаторы ТС 6510 + 0 6511 + ] 6512 +} 6513 +))) 6514 + 6515 +((( 6686 6686 6687 6687 ))) 6518 + 6519 +((( 6520 + 6688 6688 ))) 6689 6689 6523 +((( 6524 +Пример ответа : 6525 +))) 6690 6690 6527 +((( 6528 + 6529 +))) 6530 + 6531 +((( 6532 +200 ~/~/ Success 6533 +))) 6534 +))) 6535 + 6536 + 6537 + 6538 + 6539 + 6540 + 6691 6691 (% class="box" lang="en-US" style="text-align: center;" %) 6692 6692 ((( 6693 6693 (% 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]] **