Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -682,6 +682,225 @@ 682 682 (% style="text-align:left" %) 683 683 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 684 684 685 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 686 + 687 +== (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == 688 + 689 +(% class="box infomessage" %) 690 +((( 691 +(% lang="en-US" %)**GET /api/v3/models/{Id}** 692 +))) 693 + 694 +Метод возвращает полную информацию о модели объекта. 695 + 696 +(% style="color:#000000" %)Метод запроса: **GET** 697 + 698 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/(% lang="en-US" %)v3/models/(% style="color:#000000" %){(%%)ID} 699 + 700 +(% style="color:#000000" %)Параметр запроса: {__**id}**__ - идентификатор модели объекта 701 + 702 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 703 + 704 +(% style="color:#000000" %)Ответ: 705 + 706 +(% style="color:#000000" %){ 707 + "parentName": "string", 708 + "name": "string", 709 + "picture": "string", 710 + "minspeed": 0, 711 + "maxspeed": 0, 712 + "width": 0, 713 + "imbeddedtrailer": true, 714 + "fueloutlay": 0, 715 + "hoppercapacity": 0, 716 + "hopperdischargespeed": 0, 717 + "modelType": 0, 718 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 719 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 720 + "deleted": true 721 +} 722 + 723 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 724 +|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта 725 +|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта 726 +|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта 727 +|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч 728 +|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч 729 +|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах 730 +|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат 731 +|(% style="width:215px" %)(% style="color:#000000" %)fueloutlay|(% style="width:861px" %)- 732 +|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера 733 +|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек 734 +|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car 735 +|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта 736 +|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта 737 +|(% style="width:215px" %)(% style="color:#000000" %)deleted|(% style="width:861px" %)Признак удаления, тип: boolean 738 + 739 +== (% style="color:#000000; font-size:16px" %)**Просмотр списка моделей**(%%) == 740 + 741 +(% class="box successmessage" %) 742 +((( 743 +(% lang="en-US" %)**POST /api/v3/models/find** 744 +))) 745 + 746 +(% style="color:#000000" %)Метод позволяет получить список всех моделей клиента, указанного в запросе. 747 + 748 +(% style="color:#000000" %)Метод запроса: **POST** 749 + 750 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/models/find 751 + 752 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 753 + 754 +(% style="color:#000000" %)Параметры в теле запроса (JSON):{ 755 + 756 +(% style="color:#000000" %) "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 757 +} 758 + 759 +(% style="color:#000000" %)Ответ: 760 + 761 +(% style="color:#000000" %)[ 762 + { 763 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 764 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 765 + "parentName": "string", 766 + "name": "string", 767 + "modelType": 0 768 + } 769 +] 770 + 771 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 772 +|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта 773 +|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта 774 +|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car 775 +|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта 776 +|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта 777 + 778 +== (% style="color:#000000; font-size:16px" %)**Добавление модели**(%%) == 779 + 780 +(% class="box successmessage" %) 781 +((( 782 +(% lang="en-US" %)**POST /api/v3/models** 783 +))) 784 + 785 +(% style="color:#000000" %)Метод позволяет добавить объект, указанный в запросе. 786 + 787 +(% style="color:#000000" %)Метод запроса: **POST** 788 + 789 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/(% lang="en-US" %)models 790 + 791 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 792 + 793 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 794 + 795 +{ 796 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 797 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 798 + "deleted": true, 799 + "extId": "string", 800 + "name": "string", 801 + "picture": "string", 802 + "minspeed": 0, 803 + "maxspeed": 0, 804 + "width": 0, 805 + "imbeddedtrailer": true, 806 + "fueloutlay": 0, 807 + "hoppercapacity": 0, 808 + "hopperdischargespeed": 0, 809 + "modelType": 0 810 +} 811 + 812 +Ответ: 813 + 814 +{ 815 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 816 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 817 + "deleted": true, 818 + "extId": "string", 819 + "name": "string", 820 + "picture": "string", 821 + "minspeed": 0, 822 + "maxspeed": 0, 823 + "width": 0, 824 + "imbeddedtrailer": true, 825 + "fueloutlay": 0, 826 + "hoppercapacity": 0, 827 + "hopperdischargespeed": 0, 828 + "modelType": 0 829 +} 830 + 831 + 832 +== (% style="color:#000000; font-size:16px" %)**Редактирование модели**(%%) == 833 + 834 +(% class="box warningmessage" %) 835 +((( 836 +(% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models** 837 +))) 838 + 839 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе. 840 + 841 +(% style="color:#000000" %)Метод запроса: **PUT** 842 + 843 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/(% lang="en-US" %)api/v3/models 844 + 845 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 846 + 847 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 848 + 849 +{ 850 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 851 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 852 + "deleted": true, 853 + "extId": "string", 854 + "name": "string", 855 + "picture": "string", 856 + "minspeed": 0, 857 + "maxspeed": 0, 858 + "width": 0, 859 + "imbeddedtrailer": true, 860 + "fueloutlay": 0, 861 + "hoppercapacity": 0, 862 + "hopperdischargespeed": 0, 863 + "modelType": 0 864 +} 865 + 866 +Ответ: 867 + 868 +{ 869 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 870 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 871 + "deleted": true, 872 + "extId": "string", 873 + "name": "string", 874 + "picture": "string", 875 + "minspeed": 0, 876 + "maxspeed": 0, 877 + "width": 0, 878 + "imbeddedtrailer": true, 879 + "fueloutlay": 0, 880 + "hoppercapacity": 0, 881 + "hopperdischargespeed": 0, 882 + "modelType": 0 883 +} 884 + 885 +== (% style="color:#000000; font-size:16px" %)**Удаление модели**(%%) == 886 + 887 +(% class="box errormessage" %) 888 +((( 889 +(% lang="en-US" %)**DELETE /api/v3/models/{Id}** 890 +))) 891 + 892 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 893 + 894 +(% style="color:#000000" %)Метод запроса: **DELETE** 895 + 896 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru(% lang="en-US" %)/api/v3/models/{Id} 897 + 898 +(% style="color:#000000" %)Параметр запроса: {**__id__**} - id модели 899 + 900 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 901 + 902 +Ответ: В случае успеха **Success 200** 903 + 685 685 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 686 686 687 687 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == ... ... @@ -1504,53 +1504,6 @@ 1504 1504 (% style="text-align:left" %) 1505 1505 (% style="color:#000000" %)} 1506 1506 1507 - 1508 -(% style="text-align:left" %) 1509 -(% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов** 1510 - 1511 -== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 1512 - 1513 -(% class="box infomessage" %) 1514 -((( 1515 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 1516 -))) 1517 - 1518 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 1519 - 1520 -(% style="color:#000000" %)Метод запроса: **POST** 1521 - 1522 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/api/v3/gis/find>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]] 1523 - 1524 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1525 - 1526 -(% style="text-align:left" %) 1527 -Тело запроса: 1528 - 1529 -(% style="text-align:left" %) 1530 -{ 1531 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 1532 -} 1533 - 1534 -(% style="text-align:left" %) 1535 -Ответ: 1536 - 1537 -[ 1538 - { 1539 - "id": 0, ~/~/ Идентификатор объекта геозоны 1540 - "name": "string", ~/~/ Название объекта геозоны 1541 - "type": 0, ~/~/ Тип объекта геозоны 1542 - "fname": "string", ~/~/ Имя файла 1543 - "parentId": "string", ~/~/ Идентификатор клиента 1544 - "radius": 0, ~/~/ Радиус геообъекта 1545 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 1546 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 1547 - "description": "string", ~/~/ Описание 1548 - "area": 0, ~/~/ Площадь, м^^2^^ 1549 - "perimetr": 0, ~/~/ Периметр, м 1550 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 1551 - } 1552 -] 1553 - 1554 1554 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = 1555 1555 1556 1556 == (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) == ... ... @@ -1669,6 +1669,322 @@ 1669 1669 } 1670 1670 ] 1671 1671 1844 +== (% style="color:#000000; font-size:16px" %)**Экспорт сообщений**(%%) == 1845 + 1846 +(% class="box infomessage" %) 1847 +((( 1848 +**POST /api/v3/vehicles/export/history** 1849 +))) 1850 + 1851 +Метод возвращает список сообщений терминала объекта за выбранный период. 1852 + 1853 +(% style="text-align: left;" %) 1854 +Метод запроса **POST** 1855 + 1856 +(% style="text-align: left;" %) 1857 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/export/history 1858 + 1859 +(% style="text-align: left;" %) 1860 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1861 + 1862 +{ 1863 + "vehicleId": 0, ~/~/ ID объекта 1864 + "asArchive": true, ~/~/ true - Архивировать файл, False - не архивировать 1865 + "from": "2023-09-27T12:17:45.973Z", ~/~/ Дата и время начала запроса 1866 + "to": "2023-09-27T12:17:45.973Z" ~/~/ Дата и время окончания запроса 1867 +} 1868 + 1869 +Ответ: 1870 + 1871 +Получаете файл. Сообщение: Code 200/Success 1872 + 1873 +== (% style="color:#000000; font-size:16px" %)**Статус экспорта сообщений**(%%) == 1874 + 1875 +(% class="box infomessage" %) 1876 +((( 1877 +**GET /api/v3/vehicles/export/history/status** 1878 +))) 1879 + 1880 +Метод возвращает список сообщений терминала объекта за выбранный период. 1881 + 1882 +(% style="text-align: left;" %) 1883 +Метод запроса **GET** 1884 + 1885 +(% style="text-align: left;" %) 1886 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/export/history/status 1887 + 1888 +(% style="text-align: left;" %) 1889 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1890 + 1891 +Ответ: 1892 + 1893 +{ 1894 + "activity": true, ~/~/ статус экспорт, где true - экспорт в процессе выполнения, false - в данный момент ничего не экспортируется. 1895 + "progress": 0, ~/~/ прогресс экспорта, от 0 до 100%. 1896 + "message": "string" ~/~/ текст описывающий статус. 1897 +} 1898 + 1899 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) = 1900 + 1901 +== (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == 1902 + 1903 +(% class="box infomessage" %) 1904 +((( 1905 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/mileageAndMotohours** 1906 +))) 1907 + 1908 +(% style="color:#000000" %)Метод запроса: **POST** 1909 + 1910 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/mileageAndMotohours 1911 + 1912 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1913 + 1914 +(% style="text-align:left" %) 1915 +Тело запроса: 1916 + 1917 +{ 1918 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1919 + "vehicleIds": [0], ~/~/ Список ID объектов 1920 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1921 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1922 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1923 +} 1924 + 1925 +Ответ: 1926 + 1927 +[ 1928 + { 1929 + "vehicleId": 0, ~/~/ ID объекта 1930 + "name": "string", ~/~/ Имя ТС 1931 + "periods": [ ~/~/ Периоды 1932 + { 1933 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1934 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1935 + "mileageBegin": 0, ~/~/ Пробег на начало периода 1936 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 1937 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 1938 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 1939 + } 1940 + ] 1941 + } 1942 +] 1943 + 1944 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 1945 + 1946 +(% class="box infomessage" %) 1947 +((( 1948 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelConsumption** 1949 +))) 1950 + 1951 +(% style="color:#000000" %)Метод запроса: **POST** 1952 + 1953 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelConsumption 1954 + 1955 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1956 + 1957 +(% style="text-align:left" %) 1958 +Тело запроса: 1959 + 1960 +{ 1961 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1962 + "vehicleIds": [0], ~/~/ Список ID объектов 1963 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1964 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1965 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1966 +} 1967 + 1968 +Ответ: 1969 + 1970 +[ 1971 + { 1972 + "vehicleId": 0, ~/~/ ID объекта 1973 + "name": "string", ~/~/ Имя ТС 1974 + "periods": [ ~/~/ Периоды 1975 + { 1976 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1977 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1978 + "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 1979 + "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 1980 + "fuelConsumption": 0, ~/~/ Расход топлива 1981 + "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 1982 + } 1983 + ] 1984 + } 1985 +] 1986 + 1987 +== (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 1988 + 1989 +(% class="box infomessage" %) 1990 +((( 1991 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelInOut** 1992 +))) 1993 + 1994 +(% style="color:#000000" %)Метод запроса: **POST** 1995 + 1996 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelInOut 1997 + 1998 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1999 + 2000 +(% style="text-align:left" %) 2001 +Тело запроса: 2002 + 2003 +{ 2004 + "vehicleIds": [0], ~/~/ Список ID объектов 2005 + "from": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время начало запроса 2006 + "to": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время окончания запроса 2007 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2008 +} 2009 + 2010 +Ответ: 2011 + 2012 +[ 2013 + { 2014 + "start": "2023-08-09T14:27:44.773Z", ~/~/ Начало периода 2015 + "end": "2023-08-09T14:27:44.773Z", ~/~/ Окончание периода 2016 + "vehicleId": 0, ~/~/ ID объекта 2017 + "name": "string", ~/~/ Имя объекта 2018 + "model": "string", ~/~/ Модель объекта 2019 + "fuels": [ ~/~/ Массив данным по заправкам и сливам 2020 + { 2021 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2022 + "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2023 + "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2024 + "valueFuel": 0, ~/~/ Количество 2025 + "fuelStart": 0, ~/~/ Уровень топлива на начало события 2026 + "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2027 + } 2028 + ] 2029 + } 2030 +] 2031 + 2032 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2033 + 2034 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2035 + 2036 +(% class="box infomessage" %) 2037 +((( 2038 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2039 +))) 2040 + 2041 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2042 + 2043 +(% style="color:#000000" %)Метод запроса: **POST** 2044 + 2045 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2046 + 2047 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2048 + 2049 +(% style="text-align:left" %) 2050 +Тело запроса: 2051 + 2052 +(% style="text-align:left" %) 2053 +{ 2054 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2055 +} 2056 + 2057 +(% style="text-align:left" %) 2058 +Ответ: 2059 + 2060 +[ 2061 + { 2062 + "id": 0, ~/~/ Идентификатор объекта геозоны 2063 + "name": "string", ~/~/ Название объекта геозоны 2064 + "type": 0, ~/~/ Тип объекта геозоны 2065 + "fname": "string", ~/~/ Имя файла 2066 + "parentId": "string", ~/~/ Идентификатор клиента 2067 + "radius": 0, ~/~/ Радиус геообъекта 2068 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2069 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2070 + "description": "string", ~/~/ Описание 2071 + "area": 0, ~/~/ Площадь, м^^2^^ 2072 + "perimetr": 0, ~/~/ Периметр, м 2073 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2074 + } 2075 +] 2076 + 2077 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2078 + 2079 +(% class="box infomessage" %) 2080 +((( 2081 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2082 +))) 2083 + 2084 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2085 + 2086 +(% style="color:#000000" %)Метод запроса: **POST** 2087 + 2088 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2089 + 2090 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2091 + 2092 +(% style="text-align:left" %) 2093 +Тело запроса: 2094 + 2095 +{ 2096 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2097 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2098 + "ids": [ ], ~/~/ Массив id объектов 2099 + "byTime": 0, ~/~/ Объединение событий по времени 2100 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2101 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2102 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2103 +} 2104 + 2105 +Ответ: 2106 +[ 2107 + { 2108 + "geozoneId": 0, ~/~/ ID геообъекта 2109 + "geozoneName": "string", ~/~/ Название геообъекта 2110 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2111 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2112 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2113 + "vehicleId": 0, ~/~/ ID объекта 2114 + "vehicleName": "string" ~/~/ Имя объекта 2115 + } 2116 +] 2117 + 2118 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2119 + 2120 +(% class="box infomessage" %) 2121 +((( 2122 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2123 +))) 2124 + 2125 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2126 + 2127 +(% style="color:#000000" %)Метод запроса: **POST** 2128 + 2129 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2130 + 2131 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2132 + 2133 +(% style="text-align:left" %) 2134 +Тело запроса: 2135 + 2136 +{ 2137 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2138 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2139 + "ids": [ ], ~/~/ Массив id геообъектов 2140 + "byTime": 0, ~/~/ Объединение событий по времени 2141 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2142 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2143 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2144 +} 2145 + 2146 +Ответ: 2147 + 2148 +[ 2149 + { 2150 + "geozoneId": 0, ~/~/ ID геообъекта 2151 + "geozoneName": "string", ~/~/ Название геообъекта 2152 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2153 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2154 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2155 + "vehicleId": 0, ~/~/ ID объекта 2156 + "vehicleName": "string" ~/~/ Имя объекта 2157 + } 2158 +] 2159 + 1672 1672 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 1673 1673 1674 1674 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -2467,7 +2467,6 @@ 2467 2467 } 2468 2468 ] 2469 2469 2470 - 2471 2471 == (% style="color:#000000; font-size:16px" %)**Получить данные карты-метки**(%%) == 2472 2472 2473 2473 (% class="box infomessage" %) ... ... @@ -2519,7 +2519,6 @@ 2519 2519 "deleted": true 2520 2520 } 2521 2521 2522 - 2523 2523 == (% style="color:#000000; font-size:16px" %)**Редактировать карту-метку**(%%) == 2524 2524 2525 2525 (% class="box warningmessage" %) ... ... @@ -2549,7 +2549,6 @@ 2549 2549 "deleted": true 2550 2550 } 2551 2551 2552 - 2553 2553 == (% style="color:#000000; font-size:16px" %)**Удалить карту-метку**(%%) == 2554 2554 2555 2555 (% class="box errormessage" %) ... ... @@ -2564,6 +2564,310 @@ 2564 2564 Success 2565 2565 2566 2566 3052 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Биллинг**(%%) = 3053 + 3054 +(% class="wikigeneratedid" %) 3055 +== (% style="color:#000000; font-size:16px" %)**Узнать баланс клиента**(%%) == 3056 + 3057 +(% class="box infomessage" %) 3058 +((( 3059 +**GET /api/v3/Billing/client/balance/{clientId}** 3060 +))) 3061 + 3062 +Параметр запроса: **clientId **- идентификатор клиента. 3063 + 3064 +Ответ: 3065 + 3066 +{ 3067 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3068 + "Balance": 0 3069 +} 3070 + 3071 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3072 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3073 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3074 + 3075 +(% class="wikigeneratedid" %) 3076 +== (% style="color:#000000; font-size:16px" %)**Узнать ограничения клиента**(%%) == 3077 + 3078 +(% class="box infomessage" %) 3079 +((( 3080 +**GET /api/v3/Billing/client/constraint/{clientId}** 3081 +))) 3082 + 3083 +Параметр запроса: **clientId **- идентификатор клиента. 3084 + 3085 +Ответ: 3086 + 3087 +{ 3088 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3089 + "CalculationType": 0, 3090 + "PermissibleBalance": 0, 3091 + "DefermentDays": 0, 3092 + "SendUiNotifications": true, 3093 + "SendEmailNotifications": true, 3094 + "IsPrivate": true, 3095 +} 3096 + 3097 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3098 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3099 +|(% style="width:215px" %)CalculationType|(% style="width:861px" %)Определяет тип расчёта, 0 - Деньги, 1 - Дни 3100 +|(% style="width:215px" %)PermissibleBalance|(% style="width:861px" %)Допустимый баланс 3101 +|(% style="width:215px" %)DefermentDays|(% style="width:861px" %)Отсрочка, количество дней. 3102 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 3103 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 3104 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 3105 + 3106 +(% class="wikigeneratedid" %) 3107 +== (% style="color:#000000; font-size:16px" %)**Узнать состояние тарифного плана клиента**(%%) == 3108 + 3109 +(% class="box infomessage" %) 3110 +((( 3111 +**GET /api/v3/Billing/client/plan/{clientId}** 3112 +))) 3113 + 3114 +Параметры запроса: 3115 + 3116 +**clientId **- идентификатор клиента. 3117 + 3118 +**planId **- идентификатор тарифного плана. 3119 + 3120 +Ответ: 3121 + 3122 +{ 3123 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3124 + "Plan": { **~/~/ Описание тарифного плана** 3125 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3126 + "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3127 + "Name": "string", 3128 + "IsArchived": true, 3129 + "Constraint": { 3130 + "CalculationType": 0, 3131 + "PermissibleBalance": 0, 3132 + "DefermentDays": 0 3133 + }, 3134 + "Features": [ **~/~/ Описание шаблона услуг тарифного плана** 3135 + { 3136 + "Feature": "string", 3137 + "IsFactual": true, 3138 + "Limit": 0, 3139 + "Price": 0, 3140 + "PeriodValue": 0, 3141 + "PeriodType": 0 3142 + } 3143 + ] 3144 + }, 3145 + "DebitDate": "2023-10-18T12:46:24.213Z", 3146 + "Features": [ **~/~/ Описание услуг тарифного плана как есть** 3147 + { 3148 + "Feature": "string", 3149 + "IsEnabled": true, 3150 + "IsPrivate": true, 3151 + "IsFactual": true, 3152 + "Limit": 0, 3153 + "Price": 0, 3154 + "DebitDate": "2023-10-18T12:46:24.213Z", 3155 + "PeriodValue": 0, 3156 + "PeriodType": 0 3157 + } 3158 + ] 3159 +} 3160 + 3161 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3162 +|ClientId|Идентификатор клиента 3163 +|Id|Идентификатор тарифного плана 3164 +|OwnerId|Идентификатор клиента-владельца 3165 +|Name|Наименование тарифного плана 3166 +|IsArchived|Признак, определяющий архивный тарифный план 3167 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3168 +|PermissibleBalance|Допустимый баланс 3169 +|DefermentDays|Отсрочка, количество дней 3170 +|Feature|Код услуги 3171 +|IsEnabled|Признак, определяющий активирована ли услуга 3172 +|IsPrivate|Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 3173 +|IsFactual|Признак, определяющий расчёт по факту 3174 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3175 +|Price|Цена за единицу. 3176 +|DebitDate|Следующий момент времени списания с баланса за услугу. 3177 +|PeriodValue|Значение периода. 3178 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 3179 + 3180 +(% class="wikigeneratedid" %) 3181 +== (% style="color:#000000; font-size:16px" %)**Получить тарифные планы принадлежащие клиенту**(%%) == 3182 + 3183 +(% class="box infomessage" %) 3184 +((( 3185 +**GET /api/v3/Billing/client/constraint/getowned/{clientId}** 3186 +))) 3187 + 3188 +Параметр запроса: **clientId **- идентификатор клиента. 3189 + 3190 +Ответ: 3191 + 3192 +[ 3193 + { 3194 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3195 + "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3196 + "Name": "string", 3197 + "IsArchived": true, 3198 + "Constraint": { 3199 + "CalculationType": 0, 3200 + "PermissibleBalance": 0, 3201 + "DefermentDays": 0 3202 + }, 3203 + "Features": [ 3204 + { 3205 + "Feature": "string", 3206 + "IsFactual": true, 3207 + "Limit": 0, 3208 + "Price": 0, 3209 + "PeriodValue": 0, 3210 + "PeriodType": 0 3211 + } 3212 + ] 3213 + } 3214 +] 3215 + 3216 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3217 +|ClientId|Идентификатор клиента 3218 +|Id|Идентификатор тарифного плана 3219 +|OwnerId|Идентификатор клиента-владельца 3220 +|Name|Наименование тарифного плана 3221 +|IsArchived|Признак, определяющий архивный тарифный план 3222 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3223 +|PermissibleBalance|Допустимый баланс 3224 +|DefermentDays|Отсрочка, количество дней 3225 +|Feature|Код услуги 3226 +|IsFactual|Признак, определяющий расчёт по факту 3227 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3228 +|Price|Цена за единицу. 3229 +|PeriodValue|Значение периода. 3230 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 3231 + 3232 +(% class="wikigeneratedid" %) 3233 +== (% style="color:#000000; font-size:16px" %)**Получить список доступных тарифных планов**(%%) == 3234 + 3235 +(% class="box infomessage" %) 3236 +((( 3237 +**GET /api/v3/Billing/client/constraint/getowned/{clientId}** 3238 +))) 3239 + 3240 +Параметр запроса: **clientId **- идентификатор клиента. 3241 + 3242 +Ответ: 3243 + 3244 +[ 3245 + { 3246 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3247 + "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3248 + "Name": "string", 3249 + "IsArchived": true, 3250 + "Constraint": { 3251 + "CalculationType": 0, 3252 + "PermissibleBalance": 0, 3253 + "DefermentDays": 0 3254 + }, 3255 + "Features": [ 3256 + { 3257 + "Feature": "string", 3258 + "IsFactual": true, 3259 + "Limit": 0, 3260 + "Price": 0, 3261 + "PeriodValue": 0, 3262 + "PeriodType": 0 3263 + } 3264 + ] 3265 + } 3266 +] 3267 + 3268 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3269 +|ClientId|Идентификатор клиента 3270 +|Id|Идентификатор тарифного плана 3271 +|OwnerId|Идентификатор клиента-владельца 3272 +|Name|Наименование тарифного плана 3273 +|IsArchived|Признак, определяющий архивный тарифный план 3274 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3275 +|PermissibleBalance|Допустимый баланс 3276 +|DefermentDays|Отсрочка, количество дней 3277 +|Feature|Код услуги 3278 +|IsFactual|Признак, определяющий расчёт по факту 3279 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3280 +|Price|Цена за единицу. 3281 +|PeriodValue|Значение периода. 3282 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 3283 + 3284 +== (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 3285 + 3286 +(% class="box warningmessage" %) 3287 +((( 3288 +**PUT /api/v3/Billing/client/constraint** 3289 +))) 3290 + 3291 +Тело запроса: 3292 + 3293 +{ 3294 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3295 + "CalculationType": 0, 3296 + "PermissibleBalance": 0, 3297 + "DefermentDays": 0, 3298 + "SendUiNotifications": true, 3299 + "SendEmailNotifications": true, 3300 + "IsPrivate": true, 3301 +} 3302 + 3303 +Ответ: Success 3304 + 3305 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3306 +|ClientId|Идентификатор клиента 3307 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3308 +|PermissibleBalance|Допустимый баланс 3309 +|DefermentDays|((( 3310 +Отсрочка, количество дней 3311 +))) 3312 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 3313 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 3314 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 3315 + 3316 +== (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 3317 + 3318 +(% class="box warningmessage" %) 3319 +((( 3320 +**PUT /api/v3/Billing/client/plan** 3321 +))) 3322 + 3323 +Тело запроса: 3324 + 3325 +{ 3326 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3327 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3328 + "Features": [ 3329 + { 3330 + "Feature": "string", 3331 + "IsEnabled": true, 3332 + "IsFactual": true, 3333 + "Limit": 0, 3334 + "Price": 0, 3335 + "DebitDate": "2023-10-18T13:26:58.987Z", 3336 + "PeriodValue": 0, 3337 + "PeriodType": 0 3338 + } 3339 + ] 3340 +} 3341 + 3342 +Ответ: Success 3343 + 3344 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3345 +|ClientId|Идентификатор клиента 3346 +|Feature|Код услуги 3347 +|IsEnabled|Признак, определяющий активирована ли услуга 3348 +|IsFactual|Признак, определяющий расчёт по факту 3349 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3350 +|Price|Цена за единицу. 3351 +|DebitDate|Следующий момент времени списания с баланса за услугу. 3352 +|PeriodValue|Значение периода. 3353 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 3354 + 3355 + 2567 2567 (% class="box" lang="en-US" style="text-align: center;" %) 2568 2568 ((( 2569 2569 (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **