Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/03/12 10:28
- Manage
-
Copy
- Actions
-
Export
-
Print Preview
- Viewers
-
Source
-
Children
-
Content
-
Attachments (1)
-
History
-
Information
-
Просмотреть отметки "Нравится"
Change comment:
There is no comment for this version
Summary
Details
-
Page properties
-
- Content
-
... ... @@ -509,11 +509,11 @@ 509 509 510 510 (% style="color:#000000" %)− возвращает информацию об объектах с учетом заданных настроек видимости объектов; 511 511 512 -(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав «Видимость объектов заблокированных договоров в панели управления» или «Видимость объектов заблокированных договоров в мониторинге»; 512 +(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав **«__Видимость объектов заблокированных договоров в панели управления__»** или **«__Видимость объектов заблокированных договоров в мониторинге__»**; 513 513 514 -(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права «Просмотр номеров телефонов объектов»; 514 +(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права **«__Просмотр номеров телефонов объектов__»**; 515 515 516 -(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права «Просмотр статуса объекта». 516 +(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права **«__Просмотр статуса объекта__»**. 517 517 518 518 (% style="color:#000000" %)Метод запроса: **POST** 519 519 ... ... @@ -527,19 +527,41 @@ 527 527 528 528 (% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON): 529 529 530 -(% class="western" style="color:#000000" %)##{ "vehicleId": null,~/~/84350, ~/~/ ID ТС (int, опционально) "name": null, ~/~/ Имя ТС (string, опционально) "imei": null,~/~/"710179307",##530 +(% class="western" style="color:#000000" %)##{## 531 531 532 -(% class="western" style="color:#000000" %)##~/~/ IMEI (string, опционально) "sim": null, ~/~/"938112", ~/~/ Номер телефона (string, опционально) "deviceTypeId": null,~/~/5## 532 +(% class="western" style="color:#000000" %)## "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) 533 + "name": null, ~/~/ Имя ТС (string, опционально) 534 + "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 535 + "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 536 + "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 537 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 538 + "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%) 539 +(% style="color:#000000" %)} 533 533 534 -(% class="western" style="color:#000000" %)##~/~/IDтипа устройства(short,опционально)"parentId":null,~/~/IDклиента(Guid,опционально)"unitId":null##541 +(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 535 535 536 -(% class="western" style="color:#000000" %)##~/~/"b33548c3-73c3-40e4-8b78-81470ae744ed" ~/~/ ID подразделения (Guid, опционально)##(% style="color:#000000" %)}543 +(% style="color:#000000" %)Ответ: 537 537 538 -(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права «Просмотр номеров телефонов объектов».545 +(% style="color:#000000" %){ 539 539 540 -(% style="color:#000000" %)Ответ: [ { «vehicleId»: «», //идентификатор объекта «name»: «», // наименование объекта «imei»: «», // IMEI объекта «deviceTypeId»: «», // идентификатор типа устройства «deviceTypeName»: «», // наименование типа устройства «sim1»: «», // первый номер телефона «sim2»: «», //второй номер телефона «parentId»: «», //идентификатор клиента-родителя «parentName»: «», //наименование клиента-родителя «modelId»: «», //идентификатор модели объекта «modelName»: «», //наименование модели объекта «unitId»: «», //идентификатор подразделения «unitName»: «», //наименование подразделения «status»: «», // статус объекта //«//createdAt//»: «» дата создания объектов //}, … ] 547 +(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 548 + "name": "" ~/~/ наименование объекта 549 + "imei": "" ~/~/ IMEI объекта 550 + "deviceTypeId": "" ~/~/ идентификатор типа устройства 551 + "deviceTypeName": "" ~/~/ наименование типа устройства 552 + "sim1": "" ~/~/ первый номер телефона 553 + "sim2": "" ~/~/ второй номер телефона 554 + "parentId": "" ~/~/ идентификатор клиента-родителя 555 + "parentName": "" ~/~/ наименование клиента-родителя 556 + "modelId": "" ~/~/ идентификатор модели объекта 557 + "modelName": "" ~/~/ наименование модели объекта 558 + "unitId": "" ~/~/ идентификатор подразделения 559 + "unitName": "" ~/~/ наименование подразделения 560 + "status": "" ~/~/ статус объекта 561 + "createdAt": "" ~/~/ дата создания объектов (%%) 562 +(% style="color:#000000" %)} 541 541 542 -(% style="color:#000000" %) Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«Просмотр номеров телефонов объектов»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«Просмотр статуса объекта»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 564 +(% style="color:#000000" %) Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 543 543 544 544 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 545 545 ... ... @@ -559,30 +559,32 @@ 559 559 560 560 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 561 561 562 -(% style="color:#000000" %)Параметры в теле запроса (JSON): {584 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 563 563 564 -(% class="western" %) 565 -{{{ "status": "", // значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 566 - // 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 567 - // 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 568 - "date": "", // Дата смены статуса (null если сменить немедленно) 569 - "description": "", // Описание 570 - "data": "", // Данные 571 - "overwrite": false, // Флаг перезаписи 572 - "stage": "", // Состояние, может быть null}}} 586 +(% style="color:#000000" %){ 573 573 574 -(% style="color:#000000" %)} 588 + "status": "", ~/~/ значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 589 + ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 590 + ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 591 + "date": "", ~/~/ Дата смены статуса (null если сменить немедленно) 592 + "description": "", ~/~/ Описание 593 + "data": "", ~/~/ Данные 594 + "overwrite": false, ~/~/ Флаг перезаписи 595 + "stage": "", ~/~/ Состояние, может быть null 575 575 576 -(% style="color:#000000" %) Ответ: {597 + (% style="color:#000000" %)} 577 577 578 -(% class="western" %) 579 -{{{ "status": "", // значение статуса 580 - "date": "", // Дата смены статуса 581 - "description": "", // Описание 582 - "data": "", // Данные 583 - "overwrite": false, // Флаг перезаписи 584 - "stage": "", // Состояние}}} 599 +(% style="color:#000000" %)Ответ: 585 585 601 +(% style="color:#000000" %){ 602 + 603 + "status": "", ~/~/ значение статуса 604 + "date": "", ~/~/ Дата смены статуса 605 + "description": "", ~/~/ Описание 606 + "data": "", ~/~/ Данные 607 + "overwrite": false, ~/~/ Флаг перезаписи 608 + "stage": "", ~/~/ Состояние 609 + 586 586 (% style="text-align:left" %) 587 587 (% style="color:#000000" %)} 588 588 ... ... @@ -602,8 +602,14 @@ 602 602 603 603 (% style="color:#000000" %)Параметры в теле запроса (JSON): 604 604 605 -(% style="color:#000000" %) //Обязательныепараметры наименование и модель объекта //В теле запроса - объект JSON{«vehicleId»: «», //ID ТС «parentId»: «», //ID клиента «name»: «», //имя ТС «imei»: «», //IMEI «deviceTypeId»: «», //ID типа устройства «modelId»: «», «unitId»: «», //ID подразделения «sim1»: «», //SIM 1 «sim2»: «», //SIM2 «consumptionPer100Km»: «», //Расход топлива на 100 км «consumptionIdle»: «», //Расход топлива на холостом ходу «counters»: { «mileageEnabled»: true, //флаг активности счётчика «пробег» «motohoursEnabled»: true, //флаг активности счётчика «моточасы» «mileage»: «», //пробег «motohours»: «» //моточасы }, «cmsv6Parameters»: { //параметры CMSv6 «id»: «», //идентификатор «enabled»: true, //флаг включения «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6 «login»: «», //имя учетной записи «password»: «» //пароль учетной записи }, «inspectionTasks»: [ //задания на ТО { «id»: «», //ID задания «enabled»: false, //Признак включения «name»: «», //Имя задания «description»: «», //Описание задания «mileageCondition»: «», //Условие по пробегу (в метрах, null - условие не работает) «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО (null - неважно) «motohoursCondition»: «», //Условие по моточасам (в секундах, null - условие не работает) «lastMotohours»: «», //Моточасы (в секундах) на момент последнего ТО (null - неважно) «periodicCondition»: «», //Условие периодичности по времени (null - условие не работает) «kind»: «», //Вид периодичности по времени «maxQuantity»: «» //Сколько раз выполнить задание } ] }629 +(% style="color:#000000" %) { 606 606 631 + 632 +(% style="color:#000000" %)«vehicleId»: «», //ID ТС «parentId»: «», //ID клиента «name»: «», //имя ТС «imei»: «», //IMEI «deviceTypeId»: «», //ID типа устройства «modelId»: «», «unitId»: «», //ID подразделения «sim1»: «», //SIM 1 «sim2»: «», //SIM2 «consumptionPer100Km»: «», //Расход топлива на 100 км «consumptionIdle»: «», //Расход топлива на холостом ходу «counters»: { «mileageEnabled»: true, //флаг активности счётчика «пробег» «motohoursEnabled»: true, //флаг активности счётчика «моточасы» «mileage»: «», //пробег «motohours»: «» //моточасы }, «cmsv6Parameters»: { //параметры CMSv6 «id»: «», //идентификатор «enabled»: true, //флаг включения «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6 «login»: «», //имя учетной записи «password»: «» //пароль учетной записи }, «inspectionTasks»: [ //задания на ТО { «id»: «», //ID задания «enabled»: false, //Признак включения «name»: «», //Имя задания «description»: «», //Описание задания «mileageCondition»: «», //Условие по пробегу (в метрах, null - условие не работает) «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО (null - неважно) «motohoursCondition»: «», //Условие по моточасам (в секундах, null - условие не работает) «lastMotohours»: «», //Моточасы (в секундах) на момент последнего ТО (null - неважно) «periodicCondition»: «», //Условие периодичности по времени (null - условие не работает) «kind»: «», //Вид периодичности по времени «maxQuantity»: «» //Сколько раз выполнить задание } ] 633 + 634 + 635 +(% style="color:#000000" %)} 636 + 607 607 (% style="color:#000000" %)Ответ: 608 608 609 609 (% lang="en-US" style="text-align:left" %)