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