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
-
- 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,6 +356,21 @@ 356 356 357 357 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 358 358 357 +== (% style="color:#000000; font-size:16px" %)**Смена статуса клиента (активация/блокировка)**(%%) == 358 + 359 +(% class="box warningmessage" %) 360 +((( 361 +**PUT /api/v3/agents/{id}/changeStatus/{status}** 362 +))) 363 + 364 +Метод позволяет изменить статус клиента, указанного в запросе. 365 + 366 +В пути указывается GUID клиента и статус клиента. 367 + 368 +**status **- значение 0 - заблокирован, 1 - активен. 369 + 370 +Ответ: Code 204 371 + 359 359 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) = 360 360 361 361 == (% style="color:#000000; font-size:16px" %)**Добавление пользователя**(%%) == ... ... @@ -1789,7 +1789,7 @@ 1789 1789 1790 1790 (% style="color:#000000" %)Метод запроса: **GET** 1791 1791 1792 -(% 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]] 1793 1793 1794 1794 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1795 1795 ... ... @@ -1872,6 +1872,56 @@ 1872 1872 } 1873 1873 ] 1874 1874 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 +Номер входа 1933 +))) 1934 + 1935 +(% class="wikigeneratedid" %) 1936 +Перечень ID протоколов в статье - [[ID протоколов для получения типов и номеров входа сырого параметра.>>https://wiki.glonasssoft.ru/bin/view/API/ID%20%D0%BF%D1%80%D0%BE%D1%82%D0%BE%D0%BA%D0%BE%D0%BB%D1%8B%20%D0%B4%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D1%82%D0%B8%D0%BF%D0%B0%20%D0%B8%20%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D0%B0%20%D0%B2%D1%85%D0%BE%D0%B4%D0%B0%20%D1%81%D1%8B%D1%80%D0%BE%D0%B3%D0%BE%20%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0/]] 1937 + 1875 1875 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1876 1876 1877 1877 (% class="box infomessage" %) ... ... @@ -1896,6 +1896,11 @@ 1896 1896 "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса 1897 1897 } 1898 1898 1962 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1963 +|vehicleId|ID объекта 1964 +|from|Дата и время начала периода запроса 1965 +|to|Дата и время окончания периода запроса 1966 + 1899 1899 Ответ: 1900 1900 1901 1901 [ ... ... @@ -1902,25 +1902,43 @@ 1902 1902 { 1903 1903 "messages": [ 1904 1904 { 1905 - "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства 1906 - "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера 1907 - "speed": 0, ~/~/ Скорость, км/ч 1908 - "altitude": 0, ~/~/ Высота, м 1909 - "latitude": 0, ~/~/ Широта [-90°;90°] 1910 - "longitude": 0, ~/~/ Долгота [-180°;180°] 1911 - "satellites": 0, ~/~/ Кол-во спутников 1912 - "voltage": 0, ~/~/ Напряжение 1913 - "parameters": { ~/~/ список параметров датчиков передаваемых терминалом 1973 + "deviceTime": "2023-11-29T07:40:44.052Z", 1974 + "serverTime": "2023-11-29T07:40:44.052Z", 1975 + "speed": 0, 1976 + "altitude": 0, 1977 + "latitude": 0, 1978 + "longitude": 0, 1979 + "satellites": 0, 1980 + "course": 0, 1981 + "voltage": 0, 1982 + "parameters": { 1914 1914 "additionalProp1": "string", 1915 1915 "additionalProp2": "string", 1916 1916 "additionalProp3": "string" 1917 1917 }, 1918 - "photoCount": 0 ~/~/ Кол-во фото 1987 + "photoCount": 0, 1988 + "lbsCorrectedCoords": true, 1989 + "protocolType": 0 1919 1919 } 1920 1920 ] 1921 1921 } 1922 1922 ] 1923 1923 1995 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1996 +|deviceTime|Время сообщения терминала 1997 +|serverTime|Время когда сообщение поступило на сервер 1998 +|speed|Скорость 1999 +|altitude|Высота над уровнем моря 2000 +|latitude|Широта 2001 +|longitude|Долгота 2002 +|satellites|Кол-во спутников 2003 +|course|Курс 2004 +|voltage|Бортовое напряжение 2005 +|parameters|Список параметров и их значений 2006 +|photoCount|Количество фото 2007 +|lbsCorrectedCoords|Признак того, что координаты были скорректированы по LBS, true - скорректированы, false - не скорректированы 2008 +|protocolType|ID типа протокола 2009 + 1924 1924 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) = 1925 1925 1926 1926 == (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == ... ... @@ -2054,6 +2054,129 @@ 2054 2054 } 2055 2055 ] 2056 2056 2143 + 2144 +== (% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов**(%%) == 2145 + 2146 +(% class="box infomessage" %) 2147 +((( 2148 +**POST /api/v3/vehicles/moveStop** 2149 +))) 2150 + 2151 +Метод запроса: **POST** 2152 + 2153 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/moveStop 2154 + 2155 +В заголовках запроса: X-Auth: Токен авторизации 2156 + 2157 + 2158 +Тело запроса: 2159 + 2160 +{ 2161 + 2162 + "vehicleIds": [ ], ~/~/ Список ID объектов 2163 + 2164 + "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2165 + 2166 + "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2167 + 2168 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2169 + 2170 +} 2171 + 2172 +Ответ: 2173 + 2174 +[ 2175 + 2176 + { 2177 + 2178 + "vehicleId": 0, ~/~/ ID объекта 2179 + 2180 + "vehicleName": "string", ~/~/ Имя объекта 2181 + 2182 + "moves": [ ~/~/ Событие движения 2183 + 2184 + { 2185 + 2186 + "mileage": 0, ~/~/ Пробег, км 2187 + 2188 + "eventId": 0, ~/~/ Идентификатор события 2189 + 2190 + "eventName": "string", ~/~/ Название события 2191 + 2192 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2193 + 2194 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2195 + 2196 + "duration": 0 ~/~/ Продолжительность события, секунд 2197 + 2198 + } 2199 + 2200 + ], 2201 + 2202 + "stops": [ ~/~/ События стоянок 2203 + 2204 + { 2205 + 2206 + "address": "string", ~/~/ Адрес события 2207 + 2208 + "eventId": 0, ~/~/ Идентификатор события 2209 + 2210 + "eventName": "string", ~/~/ Название события 2211 + 2212 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2213 + 2214 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2215 + 2216 + "duration": 0 ~/~/ Продолжительность события, секунд 2217 + 2218 + 2219 + } 2220 + 2221 + ] 2222 + 2223 + } 2224 + 2225 +] 2226 + 2227 + 2228 + 2229 +== (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2230 + 2231 +(% class="box infomessage" %) 2232 +((( 2233 +**POST /api/v3/vehicles/getlastdata** 2234 +))) 2235 + 2236 +Метод запроса: **POST** 2237 + 2238 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/getlastdata 2239 + 2240 +В заголовках запроса: X-Auth: Токен авторизации 2241 + 2242 + 2243 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2244 + 2245 +Ответ: 2246 + { 2247 + "vehicleId": 0, ~/~/Идентификатор объекта. 2248 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2249 + "vehicleNumber": "string",~/~/Номер объекта. 2250 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2251 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2252 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2253 + "speed": 0,~/~/Скорость объекта. 2254 + "course": 0,~/~/Курс движения [0;360] 2255 + "latitude": 0,~/~/Широта [-90°;90°]. 2256 + "longitude": 0,~/~/Долгота [-180°;180°]. 2257 + "address": "string",~/~/Адрес. 2258 + "geozones": [ ~/~/Сведения по геозонам. 2259 + { 2260 + "id": 0, 2261 + "name": "string" 2262 + } 2263 + 2264 + 2265 + 2057 2057 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2058 2058 2059 2059 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -3406,6 +3406,8 @@ 3406 3406 **PUT /api/v3/Billing/client/balance** 3407 3407 ))) 3408 3408 3618 +Устанавливает указанное значение баланса не создавая операции пополнение/снятие. 3619 + 3409 3409 Тело запроса: 3410 3410 3411 3411 { ... ... @@ -3419,6 +3419,50 @@ 3419 3419 |(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3420 3420 |(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3421 3421 3633 +== (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 3634 + 3635 +(% class="box warningmessage" %) 3636 +((( 3637 +**PUT /api/v3/billing/client/balance/deposit** 3638 +))) 3639 + 3640 +Создает операцию **Пополнение **с указанной суммой 3641 + 3642 +Тело запроса: 3643 + 3644 +{ 3645 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3646 + "Balance": 0 3647 +} 3648 + 3649 +Ответ: Success 3650 + 3651 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3652 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3653 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3654 + 3655 +== (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 3656 + 3657 +Создает операцию **Списание **с указанной суммой 3658 + 3659 +(% class="box warningmessage" %) 3660 +((( 3661 +**PUT /api/v3/billing/client/balance/withdraw** 3662 +))) 3663 + 3664 +Тело запроса: 3665 + 3666 +{ 3667 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3668 + "Balance": 0 3669 +} 3670 + 3671 +Ответ: Success 3672 + 3673 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3674 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3675 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3676 + 3422 3422 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 3423 3423 3424 3424 (% class="box warningmessage" %) ... ... @@ -3505,22 +3505,95 @@ 3505 3505 **POST /api/v3/vehicles/import/{agentId}** 3506 3506 ))) 3507 3507 3508 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp ** . В формате**xml **экспортируютсяобъектыизнашей системы.3763 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 3509 3509 3510 -**agentId** - , указывается в пути запроса.(обязательный)3765 +В пути указывается **agentId** - id клиента. 3511 3511 3767 +**Заголовок** 3512 3512 3769 +**X-Auth: [токен авторизации]** 3770 + 3771 +**Параметры** 3772 + 3773 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3774 +|withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3775 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 3776 + 3777 +В теле использовать тип **form-data,** тип значения** file** 3778 + 3779 +**Ключи** 3780 + 3781 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3782 +|data|В значении передаем файл объекта, формат **xml** или **wlp ** 3783 +|csv|В значении передаем файл датчиков, формат **csv** 3784 + 3785 +Ответ: 3786 + 3787 +{ 3788 + "vehicleId": 0, 3789 + "name": "string", 3790 + "errors": ["string"] 3791 +} 3792 + 3793 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3794 +|vehicleId|ID созданного объекта 3795 +|name|Имя созданного объекта 3796 +|errors|Ошибки и их описание 3797 + 3513 3513 == (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) == 3514 3514 3515 3515 (% class="box infomessage" %) 3516 3516 ((( 3517 -**POST /api/v3/vehicles/import/history/{vehicleId}** 3802 +**POST** **/api/v3/vehicles/import/history/{vehicleId}** 3518 3518 ))) 3519 3519 3520 3520 (% class="wikigeneratedid" %) 3521 -** vehicleId**-idобъекта.3806 +Позволяет импортировать сообщения в выбранный объект. Сообщения должны иметь формат **wln** или **json**. Также они могут быть упакованы и переданы в виде в **zip-архива**. 3522 3522 3808 +(% class="wikigeneratedid" %) 3809 +В пути указывается **vehicleId **- id объекта. 3523 3523 3811 +**Заголовок** 3812 + 3813 +**X-Auth: [токен авторизации]** 3814 + 3815 +В теле использовать тип **form-data.** 3816 + 3817 +Ключи: 3818 + 3819 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3820 +|**history**|В значении передавать файл с историей 3821 + 3822 +В случае, если загружается история из файла **wln **можно выполнять подмену названий параметров. В ключе вы указываете название параметра из файла, в значении указываете значение на которое нужно заменить. 3823 + 3824 +Ответ: 3825 + 3826 +{ 3827 + "results": [ 3828 + { 3829 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3830 + "vehicleId": 0, 3831 + "errors": [ 3832 + "string" 3833 + ], 3834 + "firstMessageDate": "2023-11-28T09:27:58.949Z", 3835 + "lastMessageDate": "2023-11-28T09:27:58.949Z", 3836 + "producedCount": 0, 3837 + "msgCount": 0 3838 + } 3839 + ] 3840 +} 3841 + 3842 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3843 +|results|Результаты импорта в разрезе ТС 3844 +|vehicleGuid|Guid ТС 3845 +|vehicleId|ID ТС 3846 +|errors|Список ошибок импорта истории (если пустой - нет ошибок) 3847 +|firstMessageDate|Дата первого импортированного сообщения (UTC) 3848 +|lastMessageDate|Дата последнего импортированного сообщения (UTC) 3849 +|producedCount|Кол-во успешно отправленных в шину данных сообщений 3850 +|msgCount|Кол-во обработанных сообщений всего 3851 + 3524 3524 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 3525 3525 3526 3526 (% class="box infomessage" %) ... ... @@ -3528,7 +3528,20 @@ 3528 3528 **GET /api/v3/vehicles/import/history/status** 3529 3529 ))) 3530 3530 3859 +Запрос статуса импорта истории. Может потребоваться в случае импорта истории за большой период. 3531 3531 3861 +Ответ: 3862 + 3863 +{ 3864 + "activity": true, 3865 + "progress": 0, 3866 + "message": "string" 3867 +} 3868 + 3869 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3870 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 3871 +|progress|Guid ТС 3872 + 3532 3532 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 3533 3533 3534 3534 (% class="box infomessage" %) ... ... @@ -3598,7 +3598,7 @@ 3598 3598 3599 3599 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) = 3600 3600 3601 -== (% style="color:#000000; font-size:16px" %)**Запрос рейтин ша качества вождения**(%%) ==3942 +== (% style="color:#000000; font-size:16px" %)**Запрос рейтинга качества вождения**(%%) == 3602 3602 3603 3603 (% class="box infomessage" %) 3604 3604 ((( ... ... @@ -3704,6 +3704,73 @@ 3704 3704 |driverName|Имя водителя 3705 3705 |driverRfid|Номер Карты-метки 3706 3706 4048 + 4049 +(% style="color:#000000; font-size:18.6667px" %)Раздел: Топливные карты 4050 + 4051 +===== **Запрос транзакций по топливным картам** ===== 4052 + 4053 +Транзакции по топливным картам можно получить при наличии права «Транзакции ТК» 4054 + 4055 +(% class="box infomessage" %) 4056 +((( 4057 +**POST**/api/v3/fuelcards/transactions 4058 +))) 4059 + 4060 +Запрос должен содержать параметры: 4061 + 4062 +{ 4063 + 4064 + "startDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата начала периода построения 4065 + 4066 + "endDate": "2024-03-14T13:10:21.797Z", ~/~/ Дата окончания периода построения 4067 + 4068 + "ids": [ 4069 + 4070 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid-ы топливных карт 4071 + 4072 + ], 4073 + 4074 + "timezone": 0, ~/~/ Часовой пояс 4075 + 4076 + "agent": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid клиента владельца 4077 + 4078 +} 4079 + 4080 +Ответ: 4081 + 4082 + { 4083 + 4084 + "date": "2024-03-14T13:14:26.212Z", ~/~/ Дата транзакции 4085 + 4086 + " driver ": "string", ~/~/ Имя водителя 4087 + 4088 + "amount": 0, ~/~/ Количество топлива 4089 + 4090 + "amountDut": 0, ~/~/ Количество топлива по ДУТ 4091 + 4092 + "amountDiff": 0, ~/~/ Разница в литрах 4093 + 4094 + "amountDiffPerc": 0, ~/~/ Разница в % 4095 + 4096 + "summa": 0, ~/~/ Стоимость в руб. 4097 + 4098 + "serviceName": "string", ~/~/ Тип топлива 4099 + 4100 + "price": 0, ~/~/ Цена за литр в руб. 4101 + 4102 + "cardName": "string", ~/~/ Наименование ТК 4103 + 4104 + "cardNum": "string", ~/~/ Номер ТК 4105 + 4106 + "operator": "string", ~/~/ Оператор ТК 4107 + 4108 + "address": "string", ~/~/ Адрес АЗС 4109 + 4110 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Guid топливной карты 4111 + 4112 + } 4113 + 4114 + 3707 3707 (% class="box" lang="en-US" style="text-align: center;" %) 3708 3708 ((( 3709 3709 (% 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]] **