Исходный код вики Дополнительные API методы
Версия 5.1 от Андрей Калиновский на 2025/08/25 16:45
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | [[< Основная страница с API запросами >>https://wiki.glonasssoft.ru/bin/view/API/]] | ||
| 2 | |||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | |||
| 6 | == Управление подразделениями == | ||
| 7 | |||
| 8 | |||
| 9 | === Поиск подразделения === | ||
| 10 | |||
| 11 | (% class="box infomessage" %) | ||
| 12 | ((( | ||
| 13 | **POST /api/v3/Units/find ** | ||
| 14 | ))) | ||
| 15 | |||
| 16 | Пример запроса: | ||
| 17 | |||
| 18 | |||
| 19 | { | ||
| 20 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения | ||
| 21 | "name": "string", ~/~/ Наименование подразделения | ||
| 22 | "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента-родителя | ||
| 23 | } | ||
| 24 | |||
| 25 | |||
| 26 | Пример ответа: | ||
| 27 | |||
| 28 | [ | ||
| 29 | { | ||
| 30 | "name": "string", ~/~/ Наименование подразделения | ||
| 31 | "description": "string", ~/~/ Дополнительное описание | ||
| 32 | "color": "string", ~/~/ Цвет | ||
| 33 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения | ||
| 34 | "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-родителя | ||
| 35 | "deleted": true ~/~/ Признак удаления | ||
| 36 | } | ||
| 37 | |||
| 38 | |||
| 39 | === Добавление подразделения === | ||
| 40 | |||
| 41 | (% class="box successmessage" %) | ||
| 42 | ((( | ||
| 43 | **POST /api/v3/Units** | ||
| 44 | ))) | ||
| 45 | |||
| 46 | |||
| 47 | Пример запроса: | ||
| 48 | |||
| 49 | |||
| 50 | { | ||
| 51 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID | ||
| 52 | "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца | ||
| 53 | "name": "string", ~/~/ Наименование | ||
| 54 | "description": "string", ~/~/ Дополнительное описание | ||
| 55 | "color": "string", ~/~/ Цвет | ||
| 56 | "extId": "string" ~/~/ extId | ||
| 57 | } | ||
| 58 | |||
| 59 | |||
| 60 | Пример ответа: | ||
| 61 | |||
| 62 | { | ||
| 63 | "name": "string", ~/~/ Наименование | ||
| 64 | "description": "string", ~/~/ Дополнительное описание | ||
| 65 | "color": "string", ~/~/ Цвет | ||
| 66 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения | ||
| 67 | "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя | ||
| 68 | "deleted": true ~/~/ Признак удаления | ||
| 69 | } | ||
| 70 | |||
| 71 | |||
| 72 | === Редактирование подразделения === | ||
| 73 | |||
| 74 | (% class="box errormessage" %) | ||
| 75 | ((( | ||
| 76 | **PUT /api/v3/Units** | ||
| 77 | ))) | ||
| 78 | |||
| 79 | Пример запроса: | ||
| 80 | |||
| 81 | { | ||
| 82 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения | ||
| 83 | "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца | ||
| 84 | "name": "string", ~/~/ Наименование | ||
| 85 | "description": "string", ~/~/ Дополнительное описание | ||
| 86 | "color": "string", ~/~/ Цвет | ||
| 87 | "extId": "string" ~/~/ extId | ||
| 88 | } | ||
| 89 | |||
| 90 | |||
| 91 | Пример ответа: | ||
| 92 | |||
| 93 | { | ||
| 94 | "name": "string", ~/~/ Наименование | ||
| 95 | "description": "string", ~/~/ Дополнительное описание | ||
| 96 | "color": "string", ~/~/ Цвет | ||
| 97 | "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID | ||
| 98 | "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя | ||
| 99 | "deleted": true ~/~/ Признак удаления | ||
| 100 | } | ||
| 101 | |||
| 102 | |||
| 103 | |||
| 104 | === Удаление подразделения === | ||
| 105 | |||
| 106 | (% class="box errormessage" %) | ||
| 107 | ((( | ||
| 108 | **DELETE /api/v3/Units/{unitId}** | ||
| 109 | ))) | ||
| 110 | |||
| 111 | unitId - Guid подразделения | ||
| 112 | |||
| 113 | |||
| 114 | Пример ответа: | ||
| 115 | |||
| 116 | 200 ~/~/ Success | ||
| 117 | |||
| 118 | |||
| 119 | |||
| 120 | == Управление группами == | ||
| 121 | |||
| 122 | |||
| 123 | === Получить информацию группы по идентификатору группы === | ||
| 124 | |||
| 125 | (% class="box infomessage" %) | ||
| 126 | ((( | ||
| 127 | **GET /api/v3/VehiclesGroups/{groupId}** | ||
| 128 | ))) | ||
| 129 | |||
| 130 | groupId - Идентификатор группы | ||
| 131 | |||
| 132 | |||
| 133 | Пример ответа: | ||
| 134 | |||
| 135 | { | ||
| 136 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 137 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 138 | "Name": "string", ~/~/ Наименование группы | ||
| 139 | "VehiclesIds": [ | ||
| 140 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 141 | ], | ||
| 142 | "ModelsIds": [ | ||
| 143 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 144 | ], | ||
| 145 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 146 | } | ||
| 147 | |||
| 148 | |||
| 149 | === Удалить группу === | ||
| 150 | |||
| 151 | (% class="box errormessage" %) | ||
| 152 | ((( | ||
| 153 | **DELETE /api/v3/VehiclesGroups/{groupId}** | ||
| 154 | ))) | ||
| 155 | |||
| 156 | groupId - Идентификатор группы | ||
| 157 | |||
| 158 | |||
| 159 | Пример ответа: | ||
| 160 | |||
| 161 | 200 ~/~/ Success | ||
| 162 | |||
| 163 | |||
| 164 | |||
| 165 | === Получить информацию группы по идентификатору клиента === | ||
| 166 | |||
| 167 | (% class="box infomessage" %) | ||
| 168 | ((( | ||
| 169 | **GET /api/v3/VehiclesGroups/list/{agentId}** | ||
| 170 | ))) | ||
| 171 | |||
| 172 | agentId - Идентификатор клиента | ||
| 173 | |||
| 174 | |||
| 175 | Пример ответа: | ||
| 176 | |||
| 177 | [ | ||
| 178 | { | ||
| 179 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 180 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 181 | "Name": "string", ~/~/ Наименование группы. | ||
| 182 | "VehiclesIds": [ | ||
| 183 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 184 | ], | ||
| 185 | "ModelsIds": [ | ||
| 186 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 187 | ], | ||
| 188 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 189 | } | ||
| 190 | ] | ||
| 191 | |||
| 192 | |||
| 193 | === Создать группу === | ||
| 194 | |||
| 195 | (% class="box successmessage" %) | ||
| 196 | ((( | ||
| 197 | **POST /api/v3/VehiclesGroups** | ||
| 198 | ))) | ||
| 199 | |||
| 200 | Пример запроса: | ||
| 201 | { | ||
| 202 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 203 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 204 | "Name": "string", ~/~/ Наименование группы. | ||
| 205 | "VehiclesIds": [ | ||
| 206 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 207 | ], | ||
| 208 | "ModelsIds": [ | ||
| 209 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 210 | ], | ||
| 211 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 212 | } | ||
| 213 | |||
| 214 | |||
| 215 | Пример ответа: | ||
| 216 | |||
| 217 | { | ||
| 218 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 219 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 220 | "Name": "string", ~/~/ Наименование группы. | ||
| 221 | "VehiclesIds": [ | ||
| 222 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 223 | ], | ||
| 224 | "ModelsIds": [ | ||
| 225 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 226 | ], | ||
| 227 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 228 | } | ||
| 229 | |||
| 230 | |||
| 231 | === Изменить группу === | ||
| 232 | |||
| 233 | (% class="box warningmessage" %) | ||
| 234 | ((( | ||
| 235 | **PUT /api/v3/VehiclesGroups** | ||
| 236 | ))) | ||
| 237 | |||
| 238 | Пример запроса: | ||
| 239 | |||
| 240 | { | ||
| 241 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 242 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 243 | "Name": "string", ~/~/ Наименование группы. | ||
| 244 | "VehiclesIds": [ | ||
| 245 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 246 | ], | ||
| 247 | "ModelsIds": [ | ||
| 248 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 249 | ], | ||
| 250 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 251 | } | ||
| 252 | |||
| 253 | |||
| 254 | Пример ответа: | ||
| 255 | |||
| 256 | { | ||
| 257 | "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор группы. | ||
| 258 | "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор владельца. | ||
| 259 | "Name": "string", ~/~/ Наименование группы. | ||
| 260 | "VehiclesIds": [ | ||
| 261 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы объектов группы. | ||
| 262 | ], | ||
| 263 | "ModelsIds": [ | ||
| 264 | "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы моделей объектов группы. | ||
| 265 | ], | ||
| 266 | "Type": 0 ~/~/ Тип группировки: 0 - по объектам, 1 - по моделям объектов | ||
| 267 | } | ||
| 268 | |||
| 269 | |||
| 270 | |||
| 271 | |||
| 272 | |||
| 273 | |||
| 274 | |||
| 275 | |||
| 276 | |||
| 277 | |||
| 278 | |||
| 279 |