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 (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. krainovim1 +XWiki.Gadmin - Content
-
... ... @@ -173,7 +173,6 @@ 173 173 { 174 174 "agentId": "",(% style="color:#000000" %) (%%) 175 175 "parentId": "", 176 - "parentName": "string", 177 177 "name": "string", 178 178 "fullName": "string", 179 179 "agentInfoType": 0, ... ... @@ -184,7 +184,6 @@ 184 184 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 185 185 |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 186 186 |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 187 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 188 188 |(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 189 189 |(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 190 190 |(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) ... ... @@ -356,7 +356,7 @@ 356 356 357 357 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 358 358 359 -== (% style="color:#000000; font-size:16px" %)** Редактированиеклиента**(%%) ==357 +== (% style="color:#000000; font-size:16px" %)**Смена статуса клиента (активация/блокировка)**(%%) == 360 360 361 361 (% class="box warningmessage" %) 362 362 ((( ... ... @@ -1804,7 +1804,7 @@ 1804 1804 1805 1805 (% style="color:#000000" %)Метод запроса: **GET** 1806 1806 1807 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/ users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]]1805 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/devices/types>>https://hosting.glonasssoft.ru/api/v3/devices/types]] 1808 1808 1809 1809 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1810 1810 ... ... @@ -1887,6 +1887,51 @@ 1887 1887 } 1888 1888 ] 1889 1889 1888 +== (% style="color:#000000; font-size:16px" %)**Получить тип и номер входа сырого параметра **(%%) == 1889 + 1890 +(% class="box infomessage" style="text-align: left;" %) 1891 +((( 1892 +**POST /api/v3/terminalMessages/mapping** 1893 +))) 1894 + 1895 +Запрос позволяет узнать тип и номер входа для сырого параметра, приходящего по указанному протоколу. 1896 + 1897 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/mapping 1898 + 1899 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1900 + 1901 +{ 1902 + "protocolType": 0, 1903 + "params": ["string"] 1904 +} 1905 + 1906 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1907 +|protocolType|ID типа протокола 1908 +|params|((( 1909 +Массив наименований параметров в сообщении 1910 +))) 1911 + 1912 +Ответ: 1913 + 1914 +{ 1915 + "protocolType": 0, 1916 + "mapping": { 1917 + "additionalProp1": { 1918 + "inputType": 0, 1919 + "inputNumber": 0 1920 + }, 1921 + "additionalProp2": { 1922 + "inputType": 0, 1923 + "inputNumber": 0 1924 + } 1925 + } 1926 +} 1927 + 1928 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1929 +|protocolType|Тип протокола 1930 +|inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный 1931 +|inputNumber|Номер входа 1932 + 1890 1890 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1891 1891 1892 1892 (% class="box infomessage" %) ... ... @@ -1911,6 +1911,11 @@ 1911 1911 "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса 1912 1912 } 1913 1913 1957 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1958 +|vehicleId|ID объекта 1959 +|from|Дата и время начала периода запроса 1960 +|to|Дата и время окончания периода запроса 1961 + 1914 1914 Ответ: 1915 1915 1916 1916 [ ... ... @@ -1917,25 +1917,43 @@ 1917 1917 { 1918 1918 "messages": [ 1919 1919 { 1920 - "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства 1921 - "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера 1922 - "speed": 0, ~/~/ Скорость, км/ч 1923 - "altitude": 0, ~/~/ Высота, м 1924 - "latitude": 0, ~/~/ Широта [-90°;90°] 1925 - "longitude": 0, ~/~/ Долгота [-180°;180°] 1926 - "satellites": 0, ~/~/ Кол-во спутников 1927 - "voltage": 0, ~/~/ Напряжение 1928 - "parameters": { ~/~/ список параметров датчиков передаваемых терминалом 1968 + "deviceTime": "2023-11-29T07:40:44.052Z", 1969 + "serverTime": "2023-11-29T07:40:44.052Z", 1970 + "speed": 0, 1971 + "altitude": 0, 1972 + "latitude": 0, 1973 + "longitude": 0, 1974 + "satellites": 0, 1975 + "course": 0, 1976 + "voltage": 0, 1977 + "parameters": { 1929 1929 "additionalProp1": "string", 1930 1930 "additionalProp2": "string", 1931 1931 "additionalProp3": "string" 1932 1932 }, 1933 - "photoCount": 0 ~/~/ Кол-во фото 1982 + "photoCount": 0, 1983 + "lbsCorrectedCoords": true, 1984 + "protocolType": 0 1934 1934 } 1935 1935 ] 1936 1936 } 1937 1937 ] 1938 1938 1990 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1991 +|deviceTime|Время сообщения терминала 1992 +|serverTime|Время когда сообщение поступило на сервер 1993 +|speed|Скорость 1994 +|altitude|Высота над уровнем моря 1995 +|latitude|Широта 1996 +|longitude|Долгота 1997 +|satellites|Кол-во спутников 1998 +|course|Курс 1999 +|voltage|Бортовое напряжение 2000 +|parameters|Список параметров и их значений 2001 +|photoCount|Количество фото 2002 +|lbsCorrectedCoords|Признак того, что координаты были скорректированы по LBS, true - скорректированы, false - не скорректированы 2003 +|protocolType|ID типа протокола 2004 + 1939 1939 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) = 1940 1940 1941 1941 == (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == ... ... @@ -2069,6 +2069,142 @@ 2069 2069 } 2070 2070 ] 2071 2071 2138 + 2139 +(% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов** 2140 + 2141 +(% class="box infomessage" %) 2142 +((( 2143 +**POST/api/v3/vehicles/moveStop** 2144 +))) 2145 + 2146 +Метод запроса: **POST** 2147 + 2148 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/moveStop 2149 + 2150 +В заголовках запроса: X-Auth: Токен авторизации 2151 + 2152 + 2153 +Тело запроса: 2154 + 2155 +{ 2156 + 2157 + "vehicleIds": [ ], ~/~/ Список ID объектов 2158 + 2159 + "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2160 + 2161 + "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2162 + 2163 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2164 + 2165 +} 2166 + 2167 + 2168 +Ответ: 2169 + 2170 +[ 2171 + 2172 + { 2173 + 2174 + "vehicleId": 0, ~/~/ ID объекта 2175 + 2176 + "vehicleName": "string", ~/~/ Имя объекта 2177 + 2178 + "moves": [ ~/~/ Событие движения 2179 + 2180 + { 2181 + 2182 + "mileage": 0, ~/~/ Пробег, км 2183 + 2184 + "eventId": 0, ~/~/ Идентификатор события 2185 + 2186 + "eventName": "string", ~/~/ Название события 2187 + 2188 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2189 + 2190 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2191 + 2192 + "duration": 0 ~/~/ Продолжительность события, секунд 2193 + 2194 + } 2195 + 2196 + ], 2197 + 2198 + "stops": [ ~/~/ События стоянок 2199 + 2200 + { 2201 + 2202 + "address": "string", ~/~/ Адрес события 2203 + 2204 + "eventId": 0, ~/~/ Идентификатор события 2205 + 2206 + "eventName": "string", ~/~/ Название события 2207 + 2208 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2209 + 2210 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2211 + 2212 + "duration": 0 ~/~/ Продолжительность события, секунд 2213 + 2214 + 2215 + } 2216 + 2217 + ] 2218 + 2219 + } 2220 + 2221 +] 2222 + 2223 + 2224 + 2225 +(% style="color:#000000; font-size:16px" %)**Получение последних данных объекта** 2226 + 2227 +Метод запроса: **POST** 2228 + 2229 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/getlastdata 2230 + 2231 +В заголовках запроса: X-Auth: Токен авторизации 2232 + 2233 + 2234 +Тело запроса: 2235 + 2236 +{ 2237 + 2238 + "vehicleIds": [ ], ~/~/ Список ID машины 2239 + 2240 + "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2241 + 2242 + "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2243 + 2244 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2245 + 2246 +} 2247 + 2248 + 2249 +Ответ: 2250 + 2251 +[ 2252 + { 2253 + "vehicleId": 0, ~/~/Идентификатор объекта. 2254 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2255 + "vehicleNumber": "string",~/~/Номер объекта. 2256 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2257 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на траспортном средстве. 2258 + "state": 0,~/~/Определяет состояния объекта в мониторинге. 2259 + "speed": 0,~/~/Скорость объекта. 2260 + "course": 0,~/~/Курс движения [0;360] 2261 + "latitude": 0,~/~/Широта [-90°;90°]. 2262 + "longitude": 0,~/~/Долгота [-180°;180°]. 2263 + "address": "string",~/~/Адрес. 2264 + "geozones": [ ~/~/Сведения по геозонам. 2265 + { 2266 + "id": 0, 2267 + "name": "string" 2268 + } 2269 + ] 2270 + } 2271 +] 2272 + 2273 + 2072 2072 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2073 2073 2074 2074 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -3745,7 +3745,7 @@ 3745 3745 3746 3746 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) = 3747 3747 3748 -== (% style="color:#000000; font-size:16px" %)**Запрос рейтин ша качества вождения**(%%) ==3950 +== (% style="color:#000000; font-size:16px" %)**Запрос рейтинга качества вождения**(%%) == 3749 3749 3750 3750 (% class="box infomessage" %) 3751 3751 (((