Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -3050,13 +3050,19 @@ 3050 3050 { 3051 3051 "name": "string", 3052 3052 "number": 0, 3053 - "period": 0, ~/~/ Частота трансляции радиометки3053 + "period": 0, 3054 3054 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3055 3055 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3056 - "deleted": true 3057 3057 } 3058 3058 ] 3059 3059 3059 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3060 +|parentId|ID клиента 3061 +|name|Название карты-метки 3062 +|number|Номер 3063 +|period|Период запросов в секундах (работает только для агрегатов) 3064 +|id|ID карты-метки 3065 + 3060 3060 == (% style="color:#000000; font-size:16px" %)**Получить данные карты-метки**(%%) == 3061 3061 3062 3062 (% class="box infomessage" %) ... ... @@ -3072,13 +3072,19 @@ 3072 3072 { 3073 3073 "name": "string", 3074 3074 "number": 0, 3075 - "period": 0, ~/~/ Частота трансляции радиометки3081 + "period": 0, 3076 3076 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3077 3077 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3078 - "deleted": true 3079 3079 } 3080 3080 ] 3081 3081 3087 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3088 +|name|Название карты-метки 3089 +|number|Номер 3090 +|period|Период запросов в секундах (работает только для агрегатов) 3091 +|id|ID карты-метки 3092 +|parentId|ID клиента 3093 + 3082 3082 == (% style="color:#000000; font-size:16px" %)**Добавить карту-метку**(%%) == 3083 3083 3084 3084 (% class="box successmessage" %) ... ... @@ -3093,7 +3093,6 @@ 3093 3093 "number": 0, 3094 3094 "period": 0, 3095 3095 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3096 - "deleted": true 3097 3097 } 3098 3098 3099 3099 Ответ: ... ... @@ -3104,9 +3104,15 @@ 3104 3104 "period": 0, 3105 3105 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3106 3106 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3107 - "deleted": true 3108 3108 } 3109 3109 3120 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3121 +|name|Название карты-метки 3122 +|number|Номер 3123 +|period|Период запросов в секундах (работает только для агрегатов) 3124 +|id|ID карты-метки 3125 +|parentId|ID клиента 3126 + 3110 3110 == (% style="color:#000000; font-size:16px" %)**Редактировать карту-метку**(%%) == 3111 3111 3112 3112 (% class="box warningmessage" %) ... ... @@ -3122,7 +3122,6 @@ 3122 3122 "period": 0, 3123 3123 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3124 3124 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3125 - "deleted": true 3126 3126 } 3127 3127 3128 3128 Ответ: ... ... @@ -3133,9 +3133,15 @@ 3133 3133 "period": 0, 3134 3134 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3135 3135 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3136 - "deleted": true 3137 3137 } 3138 3138 3154 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3155 +|name|Название карты-метки 3156 +|number|Номер 3157 +|period|Период запросов в секундах (работает только для агрегатов) 3158 +|id|ID карты-метки 3159 +|parentId|ID клиента 3160 + 3139 3139 == (% style="color:#000000; font-size:16px" %)**Удалить карту-метку**(%%) == 3140 3140 3141 3141 (% class="box errormessage" %) ... ... @@ -3471,6 +3471,58 @@ 3471 3471 3472 3472 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 3473 3473 3496 +(% class="box warningmessage" %) 3497 +((( 3498 +Для тестирования запросов **Импорта **в Postman необходимо скачать его на ПК. Версия в браузере не позволяет загружать файлы в тело запроса. 3499 +))) 3500 + 3501 +== (% style="color:#000000; font-size:16px" %)**Импорт объектов**(%%) == 3502 + 3503 +(% class="box infomessage" %) 3504 +((( 3505 +**POST /api/v3/vehicles/import/{agentId}** 3506 +))) 3507 + 3508 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp **. В формате **xml **экспортируются объекты из нашей системы. 3509 + 3510 +**agentId** - id клиента, указывается в пути запроса. (обязательный) 3511 + 3512 +== (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) == 3513 + 3514 +(% class="box infomessage" %) 3515 +((( 3516 +**POST /api/v3/vehicles/import/history/{vehicleId}** 3517 +))) 3518 + 3519 +(% class="wikigeneratedid" %) 3520 +**vehicleId **- id объекта. 3521 + 3522 + 3523 +== (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 3524 + 3525 +(% class="box infomessage" %) 3526 +((( 3527 +**GET /api/v3/vehicles/import/history/status** 3528 +))) 3529 + 3530 + 3531 +== (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 3532 + 3533 +(% class="box infomessage" %) 3534 +((( 3535 +**POST /api/v3/vehicles/export** 3536 +))) 3537 + 3538 +Запрос позволяет экспортировать файлы с настройками объектов. В запросе передается массив id объектов. 3539 + 3540 +Тело запроса: 3541 + 3542 +[ 3543 + id 3544 +] 3545 + 3546 +Ответ: Success 200, получаете файлы с настройками. 3547 + 3474 3474 == (% style="color:#000000; font-size:16px" %)**Экспорт сообщений**(%%) == 3475 3475 3476 3476 (% class="box infomessage" %) ... ... @@ -3521,24 +3521,114 @@ 3521 3521 |progress|Прогресс экспорта, от 0 до 100% 3522 3522 |message|Текст описывающий статус 3523 3523 3524 -= =(% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==3598 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) = 3525 3525 3600 +== (% style="color:#000000; font-size:16px" %)**Запрос рейтинша качества вождения**(%%) == 3601 + 3526 3526 (% class="box infomessage" %) 3527 3527 ((( 3528 -**POST /api/v3/v ehicles/export**3604 +**POST /api/v3/EcoDriving/rating** 3529 3529 ))) 3530 3530 3531 - Запрос позволяетэкспортироватьфайлыснастройками объектов. Взапросе передается массивidобъектов.3607 +Позволяет получить данные рейтинга нарушений выбранных объектов за указанный период времени. Данные, выдаваемые этим запросом аналогичны тем, что вы можете увидеть в окне **Качество вождения** в мониторинге. В массиве **items **передается список объектов из рейтинга качества вождения, в **trips **передается информация по отдельным рейсам объекта. 3532 3532 3533 3533 Тело запроса: 3534 3534 3535 -[ 3536 - id 3537 -] 3611 +{ 3612 + "vehicleIds": [vehicleId], 3613 + "from": "2023-11-22T09:29:48.051Z", 3614 + "to": "2023-11-22T09:29:48.051Z" 3615 +} 3538 3538 3539 -Ответ: Success 200, получаете файлы с настройками. 3617 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3618 +|vehicleIds|Массив ID объектов 3619 +|from|Дата начала запроса 3620 +|to|Дата окончания запроса 3540 3540 3622 +Ответ: 3541 3541 3624 +{ 3625 + "items": [ 3626 + { 3627 + "from": "2023-11-22T09:29:48.052Z", 3628 + "to": "2023-11-22T09:29:48.052Z", 3629 + "vehicleId": 0, 3630 + "vehicleName": "string", 3631 + "vehicleModel": "string", 3632 + "penalty": 0, 3633 + "score": 0, 3634 + "totalViolations": 0, 3635 + "violationsByType": { 3636 + "overspeedingViolations": 0, 3637 + "accelerationViolations": 0, 3638 + "brakingViolations": 0, 3639 + "turningViolations": 0, 3640 + "dangerousDrivingViolations": 0, 3641 + "sensorViolations": 0 3642 + }, 3643 + "moveTime": 0, 3644 + "mileage": 0, 3645 + "tripsCount": 0, 3646 + "trips": [ 3647 + { 3648 + "penalty": 0, 3649 + "score": 0, 3650 + "violationsCount": 0, 3651 + "violationsByType": { 3652 + "overspeedingViolations": 0, 3653 + "accelerationViolations": 0, 3654 + "brakingViolations": 0, 3655 + "turningViolations": 0, 3656 + "dangerousDrivingViolations": 0, 3657 + "sensorViolations": 0 3658 + }, 3659 + "moveTime": 0, 3660 + "mileage": 0, 3661 + "motohours": 0, 3662 + "maxSpeed": 0, 3663 + "startAddress": "string", 3664 + "endAddress": "string", 3665 + "drivers": [ 3666 + { 3667 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3668 + "driverName": "string", 3669 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 3670 + } 3671 + ] 3672 + } 3673 + ] 3674 + } 3675 + ] 3676 +} 3677 + 3678 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3679 +|from|Дата начала запроса 3680 +|to|Дата окончания 3681 +|vehicleId|ID объекта 3682 +|vehicleName|Имя объекта 3683 +|vehicleModel|Модель объекта 3684 +|penalty|Сумма штрафных баллов 3685 +|score|Оценка 3686 +|totalViolations|Суммарное количество нарушений 3687 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3688 +|overspeedingViolations|Превышение скорости 3689 +|accelerationViolations|Ускорение 3690 +|brakingViolations|Торможение 3691 +|turningViolations|Резкий поворот 3692 +|dangerousDrivingViolations|Резкое вождение 3693 +|sensorViolations|Нарушение по датчику 3694 +|moveTime|Время в движении 3695 +|mileage|Пробег 3696 +|tripsCount|Количество рейсов 3697 +|motohours|Моточасы 3698 +|maxSpeed|Максимальная скорость 3699 +|startAddress|Адрес начала рейса 3700 +|endAddress|Адрес окончания рейса 3701 +|drivers|Список водителей, которые были на объекте в течениии рейса 3702 +|driverGuid|Guid водителя 3703 +|driverName|Имя водителя 3704 +|driverRfid|Номер Карты-метки 3705 + 3542 3542 (% class="box" lang="en-US" style="text-align: center;" %) 3543 3543 ((( 3544 3544 (% 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]] **