Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- 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" %)**Добавление пользователя**(%%) == ... ... @@ -3421,8 +3421,6 @@ 3421 3421 **PUT /api/v3/Billing/client/balance** 3422 3422 ))) 3423 3423 3424 -Устанавливает указанное значение баланса не создавая операции пополнение/снятие. 3425 - 3426 3426 Тело запроса: 3427 3427 3428 3428 { ... ... @@ -3436,50 +3436,6 @@ 3436 3436 |(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3437 3437 |(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3438 3438 3439 -== (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 3440 - 3441 -(% class="box warningmessage" %) 3442 -((( 3443 -**PUT /api/v3/billing/client/balance/deposit** 3444 -))) 3445 - 3446 -Создает операцию **Пополнение **с указанной суммой 3447 - 3448 -Тело запроса: 3449 - 3450 -{ 3451 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3452 - "Balance": 0 3453 -} 3454 - 3455 -Ответ: Success 3456 - 3457 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3458 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3459 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3460 - 3461 -== (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 3462 - 3463 -Создает операцию **Списание **с указанной суммой 3464 - 3465 -(% class="box warningmessage" %) 3466 -((( 3467 -**PUT /api/v3/billing/client/balance/withdraw** 3468 -))) 3469 - 3470 -Тело запроса: 3471 - 3472 -{ 3473 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3474 - "Balance": 0 3475 -} 3476 - 3477 -Ответ: Success 3478 - 3479 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3480 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3481 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3482 - 3483 3483 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 3484 3484 3485 3485 (% class="box warningmessage" %) ... ... @@ -3554,11 +3554,6 @@ 3554 3554 3555 3555 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 3556 3556 3557 -(% class="box warningmessage" %) 3558 -((( 3559 -Для тестирования запросов **Импорта **в Postman необходимо скачать его на ПК. Версия в браузере не позволяет загружать файлы в тело запроса. 3560 -))) 3561 - 3562 3562 == (% style="color:#000000; font-size:16px" %)**Импорт объектов**(%%) == 3563 3563 3564 3564 (% class="box infomessage" %) ... ... @@ -3566,95 +3566,20 @@ 3566 3566 **POST /api/v3/vehicles/import/{agentId}** 3567 3567 ))) 3568 3568 3569 - Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате**xml**или**wlp.**Такжеони могутнаходится в** zip-архиве.**3503 +**agentId** - id клиента. 3570 3570 3571 -В пути указывается **agentId** - id клиента. 3572 3572 3573 -**Заголовок** 3574 - 3575 -**X-Auth: [токен авторизации]** 3576 - 3577 -**Параметры** 3578 - 3579 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3580 -|withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3581 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 3582 - 3583 -В теле использовать тип **form-data,** тип значения** file** 3584 - 3585 -**Ключи** 3586 - 3587 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3588 -|data|В значении передаем файл объекта, формат **xml** или **wlp ** 3589 -|csv|В значении передаем файл датчиков, формат **csv** 3590 - 3591 -Ответ: 3592 - 3593 -{ 3594 - "vehicleId": 0, 3595 - "name": "string", 3596 - "errors": ["string"] 3597 -} 3598 - 3599 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3600 -|vehicleId|ID созданного объекта 3601 -|name|Имя созданного объекта 3602 -|errors|Ошибки и их описание 3603 - 3604 3604 == (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) == 3605 3605 3606 3606 (% class="box infomessage" %) 3607 3607 ((( 3608 -**POST ****/api/v3/vehicles/import/history/{vehicleId}**3510 +**POST /api/v3/vehicles/import/history/{vehicleId}** 3609 3609 ))) 3610 3610 3611 3611 (% class="wikigeneratedid" %) 3612 - Позволяет импортировать сообщения в выбранный объект. Сообщения должны иметь формат**wln**или**json**.Такжеони могутбыть упакованы и переданы в виде в **zip-архива**.3514 +**vehicleId **- id объекта. 3613 3613 3614 -(% class="wikigeneratedid" %) 3615 -В пути указывается **vehicleId **- id объекта. 3616 3616 3617 -**Заголовок** 3618 - 3619 -**X-Auth: [токен авторизации]** 3620 - 3621 -В теле использовать тип **form-data.** 3622 - 3623 -Ключи: 3624 - 3625 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3626 -|**history**|В значении передавать файл с историей 3627 - 3628 -В случае, если загружается история из файла **wln **можно выполнять подмену названий параметров. В ключе вы указываете название параметра из файла, в значении указываете значение на которое нужно заменить. 3629 - 3630 -Ответ: 3631 - 3632 -{ 3633 - "results": [ 3634 - { 3635 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3636 - "vehicleId": 0, 3637 - "errors": [ 3638 - "string" 3639 - ], 3640 - "firstMessageDate": "2023-11-28T09:27:58.949Z", 3641 - "lastMessageDate": "2023-11-28T09:27:58.949Z", 3642 - "producedCount": 0, 3643 - "msgCount": 0 3644 - } 3645 - ] 3646 -} 3647 - 3648 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3649 -|results|Результаты импорта в разрезе ТС 3650 -|vehicleGuid|Guid ТС 3651 -|vehicleId|ID ТС 3652 -|errors|Список ошибок импорта истории (если пустой - нет ошибок) 3653 -|firstMessageDate|Дата первого импортированного сообщения (UTC) 3654 -|lastMessageDate|Дата последнего импортированного сообщения (UTC) 3655 -|producedCount|Кол-во успешно отправленных в шину данных сообщений 3656 -|msgCount|Кол-во обработанных сообщений всего 3657 - 3658 3658 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 3659 3659 3660 3660 (% class="box infomessage" %) ... ... @@ -3662,20 +3662,7 @@ 3662 3662 **GET /api/v3/vehicles/import/history/status** 3663 3663 ))) 3664 3664 3665 -Запрос статуса импорта истории. Может потребоваться в случае импорта истории за большой период. 3666 3666 3667 -Ответ: 3668 - 3669 -{ 3670 - "activity": true, 3671 - "progress": 0, 3672 - "message": "string" 3673 -} 3674 - 3675 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3676 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 3677 -|progress|Guid ТС 3678 - 3679 3679 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 3680 3680 3681 3681 (% class="box infomessage" %)