Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/07/19 13:24
on 2024/07/19 13:24
edited by Андрей Калиновский
on 2024/07/19 14:12
on 2024/07/19 14:12
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1209,6 +1209,87 @@ 1209 1209 (% style="text-align:left" %) 1210 1210 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1211 1211 1212 +(% class="wikigeneratedid" %) 1213 +===== ===== 1214 + 1215 +(% class="wikigeneratedid" %) 1216 +===== **Получить ответ на отправленную на ТС команду** ===== 1217 + 1218 +(% class="box infomessage" %) 1219 +((( 1220 +(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1221 +))) 1222 + 1223 +Идентификатор команды: cmdid 1224 + 1225 + 1226 +Запрос от терминала на ответ команды 1227 + 1228 + 1229 +Пример ответ от терминала: 1230 + 1231 + 1232 +ID= "" ~/~/ идентификатор произвольного поля 1233 + 1234 +Soft="" ~/~/ версия софта 1235 + 1236 +GPS=4 ~/~/ тип трекера 1237 + 1238 +Time=11:05:43 28.06.24 ~/~/ время запроса 1239 + 1240 +Lat=45.056221 ~/~/ широта 1241 + 1242 +Lon=39.035938 ~/~/ долгота 1243 + 1244 +Speed=0.0 ~/~/ скорость 1245 + 1246 +Course=181.4 ~/~/направление 1247 + 1248 + 1249 + 1250 +((( 1251 +(% class="wikigeneratedid" %) 1252 +===== **Список отправленных объекту команд с ответами** ===== 1253 + 1254 +(% class="box infomessage" %) 1255 +((( 1256 +(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history** 1257 +))) 1258 + 1259 +Идентификатор ТС: vehicleId 1260 + 1261 + 1262 +В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1263 + 1264 + 1265 +Пример ответа терминала 1266 + 1267 + 1268 +[ 1269 + 1270 +{ 1271 + 1272 +"id": "", ~/~/ идентификатор пользователя 1273 + 1274 +"commandText": "", ~/~/Текст команды. 1275 + 1276 +"templateId": "", ~/~/Идентификатор шаблона 1277 + 1278 +"updated": "", ~/~/ Время отправки 1279 + 1280 +"tryCount": 0, ~/~/ Количество попыток отправки команды 1281 + 1282 +"answer": "", ~/~/ Ответ терминала. 1283 + 1284 +"status": "" ~/~/ Статус отправки 1285 + 1286 +} 1287 + 1288 +] 1289 + 1290 + 1291 +))) 1292 + 1212 1212 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == 1213 1213 1214 1214 (% class="box successmessage" %) ... ... @@ -1552,6 +1552,30 @@ 1552 1552 (% style="text-align:left" %) 1553 1553 (% style="color:#000000" %) } 1554 1554 1636 +(% class="wikigeneratedid" id="H41843743C43543D43543D43843544144243044244344143043E43144A43543A442430" %) 1637 +**Отправить команду на терминал** 1638 + 1639 +(% class="box successmessage" %) 1640 +((( 1641 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1642 +))) 1643 + 1644 +Команда для отправки на тс. 1645 + 1646 + 1647 +{ 1648 + 1649 +"id": "", ~/~/идентификатор произвольного поля 1650 + 1651 +"command": "", ~/~/ Текст команды 1652 + 1653 +"retries": "", ~/~/ Количество попыток 1654 + 1655 +"idTemplate": "" ~/~/ ID шаблона команды 1656 + 1657 +} 1658 + 1659 + 1555 1555 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1556 1556 1557 1557 (% class="box warningmessage" %) ... ... @@ -4116,6 +4116,424 @@ 4116 4116 4117 4117 } 4118 4118 4224 + 4225 +==== (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** ==== 4226 + 4227 + 4228 +==== **Получение полных данных о ретрансляторе** ==== 4229 + 4230 +(% class="box infomessage" %) 4231 +((( 4232 +**GET ** **/api/v3/retranslations/{id}** 4233 +))) 4234 + 4235 +Идентификатор запроса: ID 4236 + 4237 + 4238 +Пример ответа: 4239 + 4240 +{ 4241 + 4242 +"description": "", ~/~/ Определяет описание 4243 + 4244 +"subscriberId": "", ~/~/ Подписчик 4245 + 4246 +"protocolType": 0, ~/~/ Тип протокола 4247 + 4248 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4249 + 4250 +"address": "string", ~/~/ Адрес события 4251 + 4252 +"objects": [ ~/~/Объекты для ретрансляции 4253 + 4254 +{ 4255 + 4256 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4257 + 4258 +"name": "", ~/~/ Наименование объекта ретрансляции 4259 + 4260 +"imei": "", ~/~/ IMEI объекта 4261 + 4262 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4263 + 4264 +} 4265 + 4266 + ], 4267 + 4268 +"id": "", ~/~/ идентификатор пользователя 4269 + 4270 +"parentId": "", ~/~/Guid родителя 4271 + 4272 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4273 + 4274 +} 4275 + 4276 + 4277 +==== **Удаление данных ретранслятора** ==== 4278 + 4279 +(% class="box infomessage" %) 4280 +((( 4281 +**DELETE** **/api/v3/retranslations/{id}** 4282 +))) 4283 + 4284 +Параметр запроса: ID 4285 + 4286 + 4287 +==== **Создание ретранслятора** ==== 4288 + 4289 +(% class="box infomessage" %) 4290 +((( 4291 +**POST ** **/api/v3/retranslations/{id}** 4292 +))) 4293 + 4294 +Запрос: 4295 + 4296 + 4297 +{ 4298 + 4299 +"description": "", ~/~/ Описание 4300 + 4301 +"subscriberId": "", ~/~/ Подписчик 4302 + 4303 +"protocolType": 0, ~/~/ Тип протокола 4304 + 4305 +"address": "", ~/~/ Адрес ретрансляции 4306 + 4307 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4308 + 4309 +"objects": [ ~/~/Объекты для ретрансляции 4310 + 4311 +{ 4312 + 4313 +"id": "", ~/~/ идентификатор пользователя 4314 + 4315 +"imei": "", ~/~/IMEI объекта 4316 + 4317 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4318 + 4319 +} 4320 + 4321 + ] 4322 + 4323 +} 4324 + 4325 + 4326 + 4327 +Ответ 4328 + 4329 +{ 4330 + 4331 +"description": "string", ~/~/ Определяет описание 4332 + 4333 +"subscriberId": "", ~/~/ идентификатор запроса 4334 + 4335 +"protocolType": 0, ~/~/ Тип протокола 4336 + 4337 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4338 + 4339 +"address": "", ~/~/ Адрес события 4340 + 4341 +"objects": [ ~/~/Объекты для ретрансляции 4342 + 4343 +{ 4344 + 4345 +"id": "", ~/~/ идентификатор пользователя 4346 + 4347 +"name": "string", ~/~/ Название уведомления 4348 + 4349 +"imei": "string", ~/~/IMEI объекта 4350 + 4351 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4352 + 4353 +} 4354 + 4355 + ], 4356 + 4357 +"id": "", ~/~/ идентификатор пользователя 4358 + 4359 +"parentId": "", ~/~/ Guid идентификатор родителя 4360 + 4361 +"deleted": true ~/~/ Признак удаления 4362 + 4363 +} 4364 + 4365 + 4366 +==== **Редактирование ретранслятора** ==== 4367 + 4368 +(% class="box infomessage" %) 4369 +((( 4370 +**PUT** **/api/v3/retranslations** 4371 +))) 4372 + 4373 +Пример запроса: 4374 + 4375 +{ 4376 + 4377 +"id": "", ~/~/ идентификатор пользователя 4378 + 4379 +"description": "string", ~/~/ Определяет описание 4380 + 4381 +"subscriberId": "", ~/~/ идентификатор запроса 4382 + 4383 +"protocolType": 0, ~/~/ Тип протокола 4384 + 4385 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4386 + 4387 +"address": "string", ~/~/ Адрес события 4388 + 4389 +"objects": ~/~/Объекты для ретрансляции 4390 + 4391 +[ 4392 + 4393 +{ 4394 + 4395 +"id": "", ~/~/ идентификатор пользователя 4396 + 4397 +"imei": "", ~/~/IMEI объекта 4398 + 4399 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4400 + 4401 +} 4402 + 4403 + ] 4404 + 4405 +} 4406 + 4407 + 4408 +Пример ответа: 4409 + 4410 +{ 4411 + 4412 +"description": "", ~/~/ Определяет описание 4413 + 4414 +"subscriberId": "", ~/~/ идентификатор запроса 4415 + 4416 +"protocolType": 0, ~/~/ Тип протокола 4417 + 4418 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4419 + 4420 +"address": "string", ~/~/ Адрес события 4421 + 4422 +"objects": [ ~/~/Объекты для ретрансляции 4423 + 4424 +{ 4425 + 4426 +"id": "", ~/~/ идентификатор пользователя 4427 + 4428 +"name": "string", ~/~/ Название уведомления 4429 + 4430 +"imei": "", ~/~/IMEI объекта 4431 + 4432 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4433 + 4434 +} 4435 + 4436 + ], 4437 + 4438 +"id": "", ~/~/ идентификатор пользователя 4439 + 4440 +"parentId": "", ~/~/ Guid идентификатор родителя 4441 + 4442 +"deleted": true ~/~/ Признак удаления 4443 + 4444 +} 4445 + 4446 + 4447 + 4448 +==== **Получение списка ретранслятора клиента** ==== 4449 + 4450 +(% class="box infomessage" %) 4451 +((( 4452 +**POST /api/v3/retranslations/find** 4453 +))) 4454 + 4455 +Пример запроса: 4456 + 4457 + 4458 +{ 4459 + 4460 +"id": "", ~/~/ идентификатор пользователя 4461 + 4462 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4463 + 4464 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4465 + 4466 +} 4467 + 4468 + 4469 + 4470 +Ответ 4471 + 4472 + 4473 +[ 4474 + 4475 +{ 4476 + 4477 +"description": "", ~/~/ Определяет описание 4478 + 4479 +"subscriberId": "", ~/~/ идентификатор запроса 4480 + 4481 +"protocolType": 0, ~/~/ Тип протокола 4482 + 4483 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4484 + 4485 +"address": "string", ~/~/ Адрес события 4486 + 4487 +"id": "", ~/~/ идентификатор пользователя 4488 + 4489 +"parentId": "", ~/~/ Guid идентификатор родителя 4490 + 4491 +"deleted": true ~/~/ Признак удаления 4492 + 4493 +} 4494 + 4495 +] 4496 + 4497 + 4498 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Отчеты**(%%) = 4499 + 4500 + 4501 +==== **API для отчета по выгрузке комбайнов** ==== 4502 + 4503 + 4504 +(% class="box infomessage" %) 4505 +((( 4506 +POST **/api/v3/Reports/harvesterUnloading** 4507 +))) 4508 + 4509 +Пример запроса: 4510 + 4511 + 4512 +{ 4513 + 4514 + "byTime": 0, ~/~/ Объединение событий по времени 4515 + 4516 + "byDist": 0, ~/~/ Объединение событий по расстоянию 4517 + 4518 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 4519 + 4520 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 4521 + 4522 + "showNearestObjects": true, ~/~/Показывать объекты рядом? 4523 + 4524 + "vehicleIds": [ ~/~/ Список id объектов для анализа 4525 + 4526 + 0 4527 + 4528 + ], 4529 + 4530 + "from": "", ~/~/ Дата и время начало запроса 4531 + 4532 + "to": "", ~/~/ Дата и время окончания запроса 4533 + 4534 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 4535 + 4536 +} 4537 + 4538 + 4539 + 4540 +Пример ответа: 4541 + 4542 + 4543 +[ 4544 + 4545 + { 4546 + 4547 + "harvesterName": "", ~/~/Комбайн, номер 4548 + 4549 + "harvesterId": 0, ~/~/Комбайн, id 4550 + 4551 +"harvesterModel": "", ~/~/ Модель комбайна 4552 + 4553 + "hopperCapacity": 0, ~/~/ Объем бункера м3 4554 + 4555 + "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек 4556 + 4557 + "events": [ ~/~/Список событий в разрезе комбайна 4558 + 4559 + { 4560 + 4561 + "driverId": "", ~/~/Идентификатор водителя 4562 + 4563 + "driverName": "", ~/~/Водитель комбайна, ФИО 4564 + 4565 + "RFID": "", ~/~/ идентификатор карты-метки 4566 + 4567 + "rfidName": "", ~/~/Водитель комбайна, имя метки 4568 + 4569 + "vehicleId": 0, ~/~/идентификатор объекта 4570 + 4571 + "vehicleName": "string", ~/~/ Имя объекта 4572 + 4573 + "modelName": "string", ~/~/ Имя модели объекта 4574 + 4575 + "nearestVehicles": [ ~/~/Объекты рядом 4576 + 4577 + { 4578 + 4579 + "vehicleId": 0, ~/~/идентификатор объекта 4580 + 4581 + "vehicleName": "string" ~/~/ Имя объекта 4582 + 4583 + } 4584 + 4585 + ], 4586 + 4587 + "fields": [ ~/~/Поля, где происходила выгрузка 4588 + 4589 + { 4590 + 4591 + "id": 0, ~/~/ идентификатор пользователя 4592 + 4593 + "name": "string" ~/~/ имя пользователя 4594 + 4595 + } 4596 + 4597 + ], 4598 + 4599 + "event": "string", ~/~/Событие 4600 + 4601 + "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода 4602 + 4603 + "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода 4604 + 4605 + "durationSeconds": 0, ~/~/Продолжительность события, в секундах 4606 + 4607 + "cultureName": "string", ~/~/ название культуры 4608 + 4609 + "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события) 4610 + 4611 + "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события) 4612 + 4613 + "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события) 4614 + 4615 + "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события) 4616 + 4617 + "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события) 4618 + 4619 + "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события) 4620 + 4621 + "issued": 0, ~/~/Выдано, бункеров 4622 + 4623 + "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера) 4624 + 4625 + "latitude": 0, ~/~/Широта 4626 + 4627 + "longitude": 0, ~/~/ Долгота 4628 + 4629 + "litresAway": 0, ~/~/Отдано, л 4630 + 4631 + "m3Away": 0 ~/~/Отдано, м3 4632 + 4633 + } 4634 + 4635 + ] 4636 + 4637 + } 4638 + 4639 +] 4640 + 4641 + 4119 4119 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 4120 4120 4121 4121 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==