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. Gadmin1 +XWiki.SupportZhuchkov - Content
-
... ... @@ -1,5 +1,17 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 +(% class="box warningmessage" %) 4 +((( 5 +(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 +просим вас соблюдать несколько простых правил при использовании API-команд:## 7 +))) 8 + 9 +* Формировать не более 3 отчётов одновременно. 10 +* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 + 12 +В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 + 14 + 3 3 **Содержание страницы:** 4 4 ))) 5 5 ... ... @@ -1182,13 +1182,15 @@ 1182 1182 Команда для отправки на тс. 1183 1183 1184 1184 { 1185 -"id": "", ~/~/идентификатор произвольногополя1186 -"command": "", ~/~/ Текст команды 1187 -"retries": "", ~/~/ Количество попыток 1188 -"idTemplate": "" ~/~/ ID шаблона команды 1197 +"id": "", ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId) 1198 +"command": "", ~/~/ Текст отправляемой команды 1199 +"retries": "", ~/~/ Количество попыток отправки на терминал 1200 +"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов). 1189 1189 } 1190 1190 1203 +В ответ получаем cmdid 1191 1191 1205 + 1192 1192 == **Получить ответ на отправленную на ТС команду** == 1193 1193 1194 1194 (% class="box infomessage" %) ... ... @@ -1196,13 +1196,13 @@ 1196 1196 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1197 1197 ))) 1198 1198 1199 -Идентификатор команды: cmd id1213 +Идентификатор команды: cmdId 1200 1200 1201 1201 Запрос от терминала на ответ команды 1202 1202 1203 1203 Пример ответ от терминала: 1204 1204 1205 -ID= "" ~/~/ идентификатор произвольного поля1219 +ID= "" ~/~/ идентификатор объекта 1206 1206 Soft="" ~/~/ версия софта 1207 1207 GPS=4 ~/~/ тип трекера 1208 1208 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -4424,22 +4424,22 @@ 4424 4424 Пример ответа: 4425 4425 4426 4426 { 4427 -"description": "", ~/~/ Определяетописание4428 -"subscriberId": "", ~/~/ Подписчик4429 -"protocolType": 0, ~/~/ Тип протокола 4430 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен4431 -"address": "string", ~/~/ Адрес события4432 -"objects": [ ~/~/Объекты для ретрансляции 4441 +"description": "", ~/~/ Поле описания ретранслятора 4442 +"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться) 4443 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4444 +"isEnabled": true, ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен 4445 +"address": "string", ~/~/ Адрес и порт принимающего сервера 4446 +"objects": [ ~/~/ Объекты для ретрансляции 4433 4433 { 4434 4434 "id": "", ~/~/ Идентификатор объекта ретрансляции 4435 4435 "name": "", ~/~/ Наименование объекта ретрансляции 4436 -"imei": "", ~/~/ IMEI объекта 4437 -"isEnabled": true ~/~/ признак,Включен,true - включен, false - отключен4450 +"imei": "", ~/~/ IMEI объекта ретрансляции 4451 +"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен 4438 4438 } 4439 4439 ], 4440 -"id": "", ~/~/ идентификаторпользователя4441 -"parentId": "", ~/~/ Guidродителя4442 -"deleted": "" ~/~/ Признак удаления ,Включен,true - включен, false - отключен4454 +"id": "", ~/~/ Идентификатор ретранслятора 4455 +"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента) 4456 +"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен 4443 4443 } 4444 4444 4445 4445 ... ... @@ -4450,7 +4450,7 @@ 4450 4450 **DELETE** **/api/v3/retranslations/{id}** 4451 4451 ))) 4452 4452 4453 -Параметр запроса: ID 4467 +Параметр запроса: ID - Идентификатор ретранслятора 4454 4454 4455 4455 4456 4456 == **Создание ретранслятора** == ... ... @@ -4463,16 +4463,16 @@ 4463 4463 Запрос: 4464 4464 4465 4465 { 4466 -"description": "", ~/~/ Описание4467 -"subscriberId": "", ~/~/ Подписчик4468 -"protocolType": 0, ~/~/ Тип протокола 4469 -"address": "", ~/~/ Адрес р етрансляции4470 -"isEnabled": "", ~/~/ признак,Включен, true - включен, false - отключен4480 +"description": "", ~/~/ Поле описания ретранслятора 4481 +"subscriberId": "", ~/~/ Идентификатор подписчика 4482 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4483 +"address": "", ~/~/ Адрес и порт принимающего сервера 4484 +"isEnabled": "", ~/~/ Признак включения ретранслятора, true - включен, false - отключен 4471 4471 "objects": [ ~/~/Объекты для ретрансляции 4472 4472 { 4473 -"id": "", ~/~/ идентификаторпользователя4474 -"imei": "", ~/~/IMEI объекта 4475 -"isEnabled": "" ~/~/ признак,Включен,true - включен, false - отключен4487 +"id": "", ~/~/ Идентификатор ретранслятора 4488 +"imei": "", ~/~/ IMEI объекта ретрансляции 4489 +"isEnabled": "" ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен 4476 4476 } 4477 4477 ] 4478 4478 } ... ... @@ -4481,22 +4481,22 @@ 4481 4481 Ответ: 4482 4482 4483 4483 { 4484 -"description": " string", ~/~/Определяетописание4485 -"subscriberId": "", ~/~/ идентификаторзапроса4486 -"protocolType": 0, 4487 -"isEnabled": "", ~/~/признак,Включен,true - включен, false - отключен4488 -"address": "", ~/~/ Адрес события4489 -"objects": [ ~/~/Объекты для ретрансляции 4498 +"description": "", ~/~/ Поле описания ретранслятора 4499 +"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться) 4500 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4501 +"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен 4502 +"address": "string", ~/~/ Адрес и порт принимающего сервера 4503 +"objects": [ ~/~/ Объекты для ретрансляции 4490 4490 { 4491 -"id": "", идентификаторпользователя4492 -"name": "string", званиеуведомления4493 -"imei": " string", ~/~/IMEI объекта4494 -"isEnabled": true ~/~/ признак,Включен,true - включен, false - отключен4505 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4506 +"name": "string", ~/~/ Наименование объекта ретрансляции 4507 +"imei": "", ~/~/ IMEI объекта ретрансляции 4508 +"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен 4495 4495 } 4496 - ], 4497 -"id": "", ~/~/ идентификаторпользователя4498 -"parentId": "", ~/~/ Guid идентификатор родителя4499 -"deleted": true ~/~/ Признак удаления 4510 + ], 4511 +"id": "", ~/~/ Идентификатор ретранслятора 4512 +"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента) 4513 +"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален 4500 4500 } 4501 4501 4502 4502 ... ... @@ -4510,18 +4510,18 @@ 4510 4510 Пример запроса: 4511 4511 4512 4512 { 4513 -"id": "", ~/~/ идентификаторпользователя4514 -"description": "string", ~/~/ Определяетописание4515 -"subscriberId": "", ~/~/ идентификаторзапроса4516 -"protocolType": 0, ~/~/ Тип протокола 4517 -"isEnabled": true, ~/~/ признак,Включен,true - включен, false - отключен4518 -"address": "string", ~/~/ Адрес события4519 -"objects": ~/~/Объекты для ретрансляции 4527 +"id": "", ~/~/ Идентификатор ретранслятора 4528 +"description": "string", ~/~/ Поле описания ретранслятора 4529 +"subscriberId": "", ~/~/ Идентификатор подписчика 4530 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4531 +"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен 4532 +"address": "string", ~/~/ Адрес и порт принимающего сервера 4533 +"objects": ~/~/ Объекты для ретрансляции 4520 4520 [ 4521 4521 { 4522 -"id": "", ~/~/ идентификаторпользователя4523 -"imei": "", ~/~/IMEI объекта 4524 -"isEnabled": true ~/~/ признак,Включен,true - включен, false - отключен4536 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4537 +"imei": "", ~/~/ IMEI объекта ретрансляции 4538 +"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен 4525 4525 } 4526 4526 ] 4527 4527 } ... ... @@ -4530,22 +4530,22 @@ 4530 4530 Пример ответа: 4531 4531 4532 4532 { 4533 -"description": "", ~/~/ Определяетописание4534 -"subscriberId": "", ~/~/ идентификаторзапроса4535 -"protocolType": 0, ~/~/ Тип протокола 4536 -"isEnabled": true, ~/~/ признак,Включен,true - включен, false - отключен4537 -"address": "string", ~/~/ Адрес события4538 -"objects": [ ~/~/Объекты для ретрансляции 4547 +"description": "", ~/~/ Поле описания ретранслятора 4548 +"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться) 4549 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4550 +"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен 4551 +"address": "string", ~/~/ Адрес и порт принимающего сервера 4552 +"objects": [ ~/~/ Объекты для ретрансляции 4539 4539 { 4540 -"id": "", ~/~/ идентификаторпользователя4541 -"name": "string", ~/~/ На званиеуведомления4542 -"imei": "", ~/~/IMEI объекта 4543 -"isEnabled": true ~/~/ признак,Включен,true - включен, false - отключен4554 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4555 +"name": "string", ~/~/ Наименование объекта ретрансляции 4556 +"imei": "", ~/~/ IMEI объекта ретрансляции 4557 +"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен 4544 4544 } 4545 4545 ], 4546 -"id": "", ~/~/ идентификаторпользователя4547 -"parentId": "", ~/~/ Guid идентификатор родителя4548 -"deleted": true ~/~/ Признак удаления 4560 +"id": "", ~/~/ Идентификатор ретранслятора 4561 +"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента) 4562 +"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален 4549 4549 } 4550 4550 4551 4551 ... ... @@ -4559,9 +4559,9 @@ 4559 4559 Пример запроса: 4560 4560 4561 4561 { 4562 -"id": "", ~/~/ идентификаторпользователя4576 +"id": "", ~/~/ Идентификатор ретранслятора 4563 4563 "search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4564 -"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4578 +"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (вышестоящего клиента). 4565 4565 } 4566 4566 4567 4567 Ответ: ... ... @@ -4568,14 +4568,14 @@ 4568 4568 4569 4569 [ 4570 4570 { 4571 -"description": "", ~/~/ Определяетописание4572 -"subscriberId": "", ~/~/ идентификаторзапроса4573 -"protocolType": 0, ~/~/ Тип протокола 4574 -"isEnabled": true, ~/~/ признак,Включен,true - включен, false - отключен4575 -"address": "string", ~/~/ Адрес события4576 -"id": "", ~/~/ идентификаторпользователя4577 -"parentId": "", ~/~/ Guid идентификатор родителя4578 -"deleted": true ~/~/ Признак удаления 4585 +"description": "", ~/~/ Поле описания ретранслятора 4586 +"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться) 4587 +"protocolType": 0, ~/~/ Тип протокола ретрансляции 4588 +"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен 4589 +"address": "string", ~/~/ Адрес и порт принимающего сервера 4590 +"id": "", ~/~/ Идентификатор ретранслятора 4591 +"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента) 4592 +"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален 4579 4579 } 4580 4580 ] 4581 4581