Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1504,7 +1504,257 @@ 1504 1504 (% style="text-align:left" %) 1505 1505 (% style="color:#000000" %)} 1506 1506 1507 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = 1507 1507 1509 +== (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) == 1510 + 1511 +(% class="box infomessage" %) 1512 +((( 1513 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types** 1514 +))) 1515 + 1516 +(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе. 1517 + 1518 +(% style="color:#000000" %)Метод запроса: **GET** 1519 + 1520 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/sensors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]] 1521 + 1522 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1523 + 1524 +(% style="color:#000000" %)Ответ: 1525 + 1526 +(% style="color:#000000" %){ 1527 + 1528 + "id": "", ~/~/ ID типа датчика 1529 + "name": "", ~/~/ Название 1530 + "description": "", ~/~/ Описание 1531 + 1532 +(% style="text-align:left" %) 1533 +(% style="color:#000000" %)} 1534 + 1535 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = 1536 + 1537 +== (% style="color:#000000; font-size:16px" %)**Данные об активности объекта**(%%) == 1538 + 1539 +(% class="box infomessage" style="text-align: left;" %) 1540 +((( 1541 +**POST /api/v3/terminalMessages/count** 1542 +))) 1543 + 1544 +(% style="text-align: left;" %) 1545 +Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период. 1546 + 1547 +(% style="text-align: left;" %) 1548 +Метод запроса **POST** 1549 + 1550 +(% style="text-align: left;" %) 1551 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/count 1552 + 1553 +(% style="text-align: left;" %) 1554 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1555 + 1556 +(% style="text-align: left;" %) 1557 +{ 1558 + "vehicleIds": [ 1559 + id ~/~/ здесь передается список идентификаторов объектов 1560 + ], 1561 + "from": "2023-03-12T07:09:02.364Z", ~/~/ от какой даты выполнять запрос 1562 + "to": "2023-03-14T07:09:02.364Z" ~/~/ до какой даты выполнять запрос 1563 +} 1564 + 1565 +(% style="text-align: left;" %) 1566 +Ответ: 1567 + 1568 +(% style="text-align: left;" %) 1569 +[ 1570 + { 1571 + "vehicleId": 0, ~/~/ идентификатор объекта 1572 + "count": 0 ~/~/ количество сообщений за период 1573 + } 1574 +] 1575 + 1576 +== (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1577 + 1578 +(% class="box infomessage" %) 1579 +((( 1580 +**POST /api/v3/terminalMessages** 1581 +))) 1582 + 1583 +Метод возвращает список сообщений терминала объекта за выбранный период. 1584 + 1585 +(% style="text-align: left;" %) 1586 +Метод запроса **POST** 1587 + 1588 +(% style="text-align: left;" %) 1589 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages 1590 + 1591 +(% style="text-align: left;" %) 1592 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1593 + 1594 +{ 1595 + "vehicleId": 0, ~/~/ id объекта 1596 + "from": "2023-03-29T09:14:46.107Z", ~/~/ начало периода запроса 1597 + "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса 1598 +} 1599 + 1600 +Ответ: 1601 + 1602 +[ 1603 + { 1604 + "messages": [ 1605 + { 1606 + "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства 1607 + "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера 1608 + "speed": 0, ~/~/ Скорость, км/ч 1609 + "altitude": 0, ~/~/ Высота, м 1610 + "latitude": 0, ~/~/ Широта [-90°;90°] 1611 + "longitude": 0, ~/~/ Долгота [-180°;180°] 1612 + "satellites": 0, ~/~/ Кол-во спутников 1613 + "voltage": 0, ~/~/ Напряжение 1614 + "parameters": { ~/~/ список параметров датчиков передаваемых терминалом 1615 + "additionalProp1": "string", 1616 + "additionalProp2": "string", 1617 + "additionalProp3": "string" 1618 + }, 1619 + "photoCount": 0 ~/~/ Кол-во фото 1620 + } 1621 + ] 1622 + } 1623 +] 1624 + 1625 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) = 1626 + 1627 +== (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == 1628 + 1629 +(% class="box infomessage" %) 1630 +((( 1631 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/mileageAndMotohours** 1632 +))) 1633 + 1634 +(% style="color:#000000" %)Метод запроса: **POST** 1635 + 1636 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/mileageAndMotohours 1637 + 1638 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1639 + 1640 +(% style="text-align:left" %) 1641 +Тело запроса: 1642 + 1643 +{ 1644 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1645 + "vehicleIds": [0], ~/~/ Список ID объектов 1646 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1647 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1648 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1649 +} 1650 + 1651 +Ответ: 1652 + 1653 +[ 1654 + { 1655 + "vehicleId": 0, ~/~/ ID объекта 1656 + "name": "string", ~/~/ Имя ТС 1657 + "periods": [ ~/~/ Периоды 1658 + { 1659 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1660 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1661 + "mileageBegin": 0, ~/~/ Пробег на начало периода 1662 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 1663 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 1664 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 1665 + } 1666 + ] 1667 + } 1668 +] 1669 + 1670 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 1671 + 1672 +(% class="box infomessage" %) 1673 +((( 1674 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelConsumption** 1675 +))) 1676 + 1677 +(% style="color:#000000" %)Метод запроса: **POST** 1678 + 1679 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelConsumption 1680 + 1681 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1682 + 1683 +(% style="text-align:left" %) 1684 +Тело запроса: 1685 + 1686 +{ 1687 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1688 + "vehicleIds": [0], ~/~/ Список ID объектов 1689 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1690 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1691 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1692 +} 1693 + 1694 +Ответ: 1695 + 1696 +[ 1697 + { 1698 + "vehicleId": 0, ~/~/ ID объекта 1699 + "name": "string", ~/~/ Имя ТС 1700 + "periods": [ ~/~/ Периоды 1701 + { 1702 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1703 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1704 + "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 1705 + "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 1706 + "fuelConsumption": 0, ~/~/ Расход топлива 1707 + "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 1708 + } 1709 + ] 1710 + } 1711 +] 1712 + 1713 +== (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 1714 + 1715 +(% class="box infomessage" %) 1716 +((( 1717 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelInOut** 1718 +))) 1719 + 1720 +(% style="color:#000000" %)Метод запроса: **POST** 1721 + 1722 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelInOut 1723 + 1724 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1725 + 1726 +(% style="text-align:left" %) 1727 +Тело запроса: 1728 + 1729 +{ 1730 + "vehicleIds": [0], ~/~/ Список ID объектов 1731 + "from": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время начало запроса 1732 + "to": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время окончания запроса 1733 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1734 +} 1735 + 1736 +Ответ: 1737 + 1738 +[ 1739 + { 1740 + "start": "2023-08-09T14:27:44.773Z", ~/~/ Начало периода 1741 + "end": "2023-08-09T14:27:44.773Z", ~/~/ Окончание периода 1742 + "vehicleId": 0, ~/~/ ID объекта 1743 + "name": "string", ~/~/ Имя объекта 1744 + "model": "string", ~/~/ Модель объекта 1745 + "fuels": [ ~/~/ Массив данным по заправкам и сливам 1746 + { 1747 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 1748 + "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 1749 + "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 1750 + "valueFuel": 0, ~/~/ Количество 1751 + "fuelStart": 0, ~/~/ Уровень топлива на начало события 1752 + "fuelEnd": 0 ~/~/ Уровень топливо на конец события 1753 + } 1754 + ] 1755 + } 1756 +] 1757 + 1508 1508 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 1509 1509 1510 1510 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -1518,7 +1518,7 @@ 1518 1518 1519 1519 (% style="color:#000000" %)Метод запроса: **POST** 1520 1520 1521 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/ users/api/v3/gis/find1771 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 1522 1522 1523 1523 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1524 1524 ... ... @@ -1633,124 +1633,6 @@ 1633 1633 } 1634 1634 ] 1635 1635 1636 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = 1637 - 1638 -== (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) == 1639 - 1640 -(% class="box infomessage" %) 1641 -((( 1642 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types** 1643 -))) 1644 - 1645 -(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе. 1646 - 1647 -(% style="color:#000000" %)Метод запроса: **GET** 1648 - 1649 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/sensors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]] 1650 - 1651 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1652 - 1653 -(% style="color:#000000" %)Ответ: 1654 - 1655 -(% style="color:#000000" %){ 1656 - 1657 - "id": "", ~/~/ ID типа датчика 1658 - "name": "", ~/~/ Название 1659 - "description": "", ~/~/ Описание 1660 - 1661 -(% style="text-align:left" %) 1662 -(% style="color:#000000" %)} 1663 - 1664 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = 1665 - 1666 -== (% style="color:#000000; font-size:16px" %)**Данные об активности объекта**(%%) == 1667 - 1668 -(% class="box infomessage" style="text-align: left;" %) 1669 -((( 1670 -**POST /api/v3/terminalMessages/count** 1671 -))) 1672 - 1673 -(% style="text-align: left;" %) 1674 -Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период. 1675 - 1676 -(% style="text-align: left;" %) 1677 -Метод запроса **POST** 1678 - 1679 -(% style="text-align: left;" %) 1680 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/count 1681 - 1682 -(% style="text-align: left;" %) 1683 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1684 - 1685 -(% style="text-align: left;" %) 1686 -{ 1687 - "vehicleIds": [ 1688 - id ~/~/ здесь передается список идентификаторов объектов 1689 - ], 1690 - "from": "2023-03-12T07:09:02.364Z", ~/~/ от какой даты выполнять запрос 1691 - "to": "2023-03-14T07:09:02.364Z" ~/~/ до какой даты выполнять запрос 1692 -} 1693 - 1694 -(% style="text-align: left;" %) 1695 -Ответ: 1696 - 1697 -(% style="text-align: left;" %) 1698 -[ 1699 - { 1700 - "vehicleId": 0, ~/~/ идентификатор объекта 1701 - "count": 0 ~/~/ количество сообщений за период 1702 - } 1703 -] 1704 - 1705 -== (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1706 - 1707 -(% class="box infomessage" %) 1708 -((( 1709 -**POST /api/v3/terminalMessages** 1710 -))) 1711 - 1712 -Метод возвращает список сообщений терминала объекта за выбранный период. 1713 - 1714 -(% style="text-align: left;" %) 1715 -Метод запроса **POST** 1716 - 1717 -(% style="text-align: left;" %) 1718 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages 1719 - 1720 -(% style="text-align: left;" %) 1721 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1722 - 1723 -{ 1724 - "vehicleId": 0, ~/~/ id объекта 1725 - "from": "2023-03-29T09:14:46.107Z", ~/~/ начало периода запроса 1726 - "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса 1727 -} 1728 - 1729 -Ответ: 1730 - 1731 -[ 1732 - { 1733 - "messages": [ 1734 - { 1735 - "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства 1736 - "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера 1737 - "speed": 0, ~/~/ Скорость, км/ч 1738 - "altitude": 0, ~/~/ Высота, м 1739 - "latitude": 0, ~/~/ Широта [-90°;90°] 1740 - "longitude": 0, ~/~/ Долгота [-180°;180°] 1741 - "satellites": 0, ~/~/ Кол-во спутников 1742 - "voltage": 0, ~/~/ Напряжение 1743 - "parameters": { ~/~/ список параметров датчиков передаваемых терминалом 1744 - "additionalProp1": "string", 1745 - "additionalProp2": "string", 1746 - "additionalProp3": "string" 1747 - }, 1748 - "photoCount": 0 ~/~/ Кол-во фото 1749 - } 1750 - ] 1751 - } 1752 -] 1753 - 1754 1754 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 1755 1755 1756 1756 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==