Changes for page Дополнительные API методы
Last modified by Андрей Калиновский on 2025/08/25 16:45
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -Дополнительные API запросы1 +Дополнительные API методы - Content
-
... ... @@ -3,9 +3,277 @@ 3 3 {{toc/}} 4 4 5 5 6 -== Управление подразделениями 6 +== Управление подразделениями == 7 7 8 8 9 +=== Поиск подразделения === 9 9 11 +(% class="box infomessage" %) 12 +((( 13 +**POST /api/v3/Units/find ** 14 +))) 10 10 11 -== Управление группами == 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 +