Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. SupportZhuchkov1 +XWiki.Gadmin - Content
-
... ... @@ -2,14 +2,13 @@ 2 2 ((( 3 3 (% class="box warningmessage" %) 4 4 ((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 -просим вас соблюдать несколько простых правил при использовании API-команд:## 5 +(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно просим вас соблюдать несколько простых правил при использовании API-команд:## 7 7 ))) 8 8 9 9 * Формировать не более 3 отчётов одновременно. 10 10 * Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 11 12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросовсопределенных IPадресов.11 +В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить работу команд. 13 13 14 14 15 15 **Содержание страницы:** ... ... @@ -1194,15 +1194,13 @@ 1194 1194 Команда для отправки на тс. 1195 1195 1196 1196 { 1197 -"id": "", ~/~/идентификатор о бъекта (онже идентификаторТС: vehicleId)1198 -"command": "", ~/~/ Текст отправляемойкоманды1199 -"retries": "", ~/~/ Количество попыток отправки на терминал1200 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).1196 +"id": "", ~/~/идентификатор произвольного поля 1197 +"command": "", ~/~/ Текст команды 1198 +"retries": "", ~/~/ Количество попыток 1199 +"idTemplate": "" ~/~/ ID шаблона команды 1201 1201 } 1202 1202 1203 -В ответ получаем cmdid 1204 1204 1205 - 1206 1206 == **Получить ответ на отправленную на ТС команду** == 1207 1207 1208 1208 (% class="box infomessage" %) ... ... @@ -1210,13 +1210,13 @@ 1210 1210 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1211 1211 ))) 1212 1212 1213 -Идентификатор команды: cmd Id1210 +Идентификатор команды: cmdid 1214 1214 1215 1215 Запрос от терминала на ответ команды 1216 1216 1217 1217 Пример ответ от терминала: 1218 1218 1219 -ID= "" ~/~/ идентификатор о бъекта1216 +ID= "" ~/~/ идентификатор произвольного поля 1220 1220 Soft="" ~/~/ версия софта 1221 1221 GPS=4 ~/~/ тип трекера 1222 1222 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -4394,31 +4394,31 @@ 4394 4394 Параметры в теле запроса (JSON): 4395 4395 4396 4396 { 4397 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ 4398 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ 4394 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4395 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4399 4399 "ids": [ 4400 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы4397 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4401 4401 ], 4402 - "timezone": 0 ~/~/ Часовойпояс4399 + "timezone": 0 ~/~/Таймзона 4403 4403 } 4404 4404 4405 4405 4406 4406 Ответ: 4407 4407 { 4408 - "date": "2024-04-11T10:41:02.265Z", ~/~/ 4409 - "driver": "string", ~/~/ 4410 - "object": "string", ~/~/ 4411 - "amount": 0, ~/~/ 4412 - "amountDut": 0, ~/~/ 4413 - "amountDiff": 0, ~/~/ 4414 - "amountDiffPerc": 0, ~/~/ 4415 - "summa": 0, ~/~/ 4416 - "serviceName": "string", ~/~/ 4417 - "price": 0, ~/~/ 4418 - "cardName": "string", ~/~/ 4419 - "cardNum": "string", ~/~/ 4420 - "operator": "string", ~/~/ 4421 - "address": "string" ~/~/ 4405 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4406 + "driver": "string", ~/~/Водители, привязанные к ТК 4407 + "object": "string", ~/~/Наименование ТС 4408 + "amount": 0, ~/~/Количество топлива 4409 + "amountDut": 0, ~/~/Количество по ДУТ 4410 + "amountDiff": 0, ~/~/Разница, л 4411 + "amountDiffPerc": 0, ~/~/Разница, % 4412 + "summa": 0, ~/~/Стоимость, руб 4413 + "serviceName": "string", ~/~/Тип топлива 4414 + "price": 0, ~/~/Цена за литр, руб 4415 + "cardName": "string", ~/~/Наименование ТК 4416 + "cardNum": "string", ~/~/Номер ТК 4417 + "operator": "string", ~/~/Оператор ТК 4418 + "address": "string" ~/~/Адрес АЗС 4422 4422 } 4423 4423 4424 4424 ... ... @@ -4432,28 +4432,28 @@ 4432 4432 **GET ** **/api/v3/retranslations/{id}** 4433 4433 ))) 4434 4434 4435 - id -Идентификаторретранслятора4432 +Идентификатор запроса: ID 4436 4436 4437 4437 4438 4438 Пример ответа: 4439 4439 4440 4440 { 4441 -"description": "", ~/~/ Поле описания ретранслятора4442 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4443 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4444 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4445 -"address": "string", ~/~/ Адрес и портпринимающего сервера4446 -"objects": [ ~/~/ 4438 +"description": "", ~/~/ Определяет описание 4439 +"subscriberId": "", ~/~/ Подписчик 4440 +"protocolType": 0, ~/~/ Тип протокола 4441 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4442 +"address": "string", ~/~/ Адрес события 4443 +"objects": [ ~/~/Объекты для ретрансляции 4447 4447 { 4448 4448 "id": "", ~/~/ Идентификатор объекта ретрансляции 4449 4449 "name": "", ~/~/ Наименование объекта ретрансляции 4450 -"imei": "", ~/~/ IMEI объекта ретрансляции4451 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4447 +"imei": "", ~/~/ IMEI объекта 4448 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4452 4452 } 4453 4453 ], 4454 -"id": "", ~/~/ Идентификаторретранслятора4455 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4456 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4451 +"id": "", ~/~/ идентификатор пользователя 4452 +"parentId": "", ~/~/Guid родителя 4453 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4457 4457 } 4458 4458 4459 4459 ... ... @@ -4464,7 +4464,7 @@ 4464 4464 **DELETE** **/api/v3/retranslations/{id}** 4465 4465 ))) 4466 4466 4467 - id - Идентификаторретранслятора4464 +Параметр запроса: ID 4468 4468 4469 4469 4470 4470 == **Создание ретранслятора** == ... ... @@ -4477,16 +4477,16 @@ 4477 4477 Запрос: 4478 4478 4479 4479 { 4480 -"description": "", ~/~/ Поле описания ретранслятора4481 -"subscriberId": "", ~/~/ Идентификатор подписчика4482 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4483 -"address": "", ~/~/ Адрес и портпринимающегосервера4484 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4477 +"description": "", ~/~/ Описание 4478 +"subscriberId": "", ~/~/ Подписчик 4479 +"protocolType": 0, ~/~/ Тип протокола 4480 +"address": "", ~/~/ Адрес ретрансляции 4481 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4485 4485 "objects": [ ~/~/Объекты для ретрансляции 4486 4486 { 4487 -"id": "", ~/~/ Идентификаторретранслятора4488 -"imei": "", ~/~/ ретрансляции4489 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4484 +"id": "", ~/~/ идентификатор пользователя 4485 +"imei": "", ~/~/IMEI объекта 4486 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4490 4490 } 4491 4491 ] 4492 4492 } ... ... @@ -4495,22 +4495,22 @@ 4495 4495 Ответ: 4496 4496 4497 4497 { 4498 -"description": "", ~/~/ Поле описания ретранслятора4499 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4500 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4501 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4502 -"address": " string", ~/~/ Адреси портпринимающего сервера4503 -"objects": [ 4495 +"description": "string", ~/~/ Определяет описание 4496 +"subscriberId": "", ~/~/ идентификатор запроса 4497 +"protocolType": 0, ~/~/ Тип протокола 4498 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4499 +"address": "", ~/~/ Адрес события 4500 +"objects": [ ~/~/Объекты для ретрансляции 4504 4504 { 4505 -"id": "", ~/~/ Идентификатор объектаретрансляции4506 -"name": "string", ~/~/ На именование объекта ретрансляции4507 -"imei": "", ретрансляции4508 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4502 +"id": "", ~/~/ идентификатор пользователя 4503 +"name": "string", ~/~/ Название уведомления 4504 +"imei": "string", ~/~/IMEI объекта 4505 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4509 4509 } 4510 - ], 4511 -"id": "", ~/~/ Идентификаторретранслятора4512 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4513 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4507 + ], 4508 +"id": "", ~/~/ идентификатор пользователя 4509 +"parentId": "", ~/~/ Guid идентификатор родителя 4510 +"deleted": true ~/~/ Признак удаления 4514 4514 } 4515 4515 4516 4516 ... ... @@ -4524,18 +4524,18 @@ 4524 4524 Пример запроса: 4525 4525 4526 4526 { 4527 -"id": "", ~/~/ Идентификаторретранслятора4528 -"description": "string", ~/~/ Поле описания ретранслятора4529 -"subscriberId": "", ~/~/ Идентификатор подписчика4530 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4531 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4532 -"address": "string", ~/~/ Адрес и портпринимающего сервера4533 -"objects": ~/~/ 4524 +"id": "", ~/~/ идентификатор пользователя 4525 +"description": "string", ~/~/ Определяет описание 4526 +"subscriberId": "", ~/~/ идентификатор запроса 4527 +"protocolType": 0, ~/~/ Тип протокола 4528 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4529 +"address": "string", ~/~/ Адрес события 4530 +"objects": ~/~/Объекты для ретрансляции 4534 4534 [ 4535 4535 { 4536 -"id": "", ~/~/ Идентификатор объектаретрансляции4537 -"imei": "", ~/~/ ретрансляции4538 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4533 +"id": "", ~/~/ идентификатор пользователя 4534 +"imei": "", ~/~/IMEI объекта 4535 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4539 4539 } 4540 4540 ] 4541 4541 } ... ... @@ -4544,22 +4544,22 @@ 4544 4544 Пример ответа: 4545 4545 4546 4546 { 4547 -"description": "", ~/~/ Поле описания ретранслятора4548 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4549 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4550 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4551 -"address": "string", ~/~/ Адрес и портпринимающего сервера4552 -"objects": [ ~/~/ 4544 +"description": "", ~/~/ Определяет описание 4545 +"subscriberId": "", ~/~/ идентификатор запроса 4546 +"protocolType": 0, ~/~/ Тип протокола 4547 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4548 +"address": "string", ~/~/ Адрес события 4549 +"objects": [ ~/~/Объекты для ретрансляции 4553 4553 { 4554 -"id": "", ~/~/ Идентификатор объектаретрансляции4555 -"name": "string", ~/~/ На именование объекта ретрансляции4556 -"imei": "", ~/~/ ретрансляции4557 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4551 +"id": "", ~/~/ идентификатор пользователя 4552 +"name": "string", ~/~/ Название уведомления 4553 +"imei": "", ~/~/IMEI объекта 4554 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4558 4558 } 4559 4559 ], 4560 -"id": "", ~/~/ Идентификаторретранслятора4561 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4562 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4557 +"id": "", ~/~/ идентификатор пользователя 4558 +"parentId": "", ~/~/ Guid идентификатор родителя 4559 +"deleted": true ~/~/ Признак удаления 4563 4563 } 4564 4564 4565 4565 ... ... @@ -4573,9 +4573,9 @@ 4573 4573 Пример запроса: 4574 4574 4575 4575 { 4576 -"id": "", ~/~/ Идентификаторретранслятора4577 -"search": "string", ~/~/ 4578 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(вышестоящего клиента).4573 +"id": "", ~/~/ идентификатор пользователя 4574 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4575 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4579 4579 } 4580 4580 4581 4581 Ответ: ... ... @@ -4582,14 +4582,14 @@ 4582 4582 4583 4583 [ 4584 4584 { 4585 -"description": "", ~/~/ Поле описания ретранслятора4586 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4587 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4588 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4589 -"address": "string", ~/~/ Адрес и портпринимающего сервера4590 -"id": "", ~/~/ Идентификаторретранслятора4591 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4592 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4582 +"description": "", ~/~/ Определяет описание 4583 +"subscriberId": "", ~/~/ идентификатор запроса 4584 +"protocolType": 0, ~/~/ Тип протокола 4585 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4586 +"address": "string", ~/~/ Адрес события 4587 +"id": "", ~/~/ идентификатор пользователя 4588 +"parentId": "", ~/~/ Guid идентификатор родителя 4589 +"deleted": true ~/~/ Признак удаления 4593 4593 } 4594 4594 ] 4595 4595