Исходный код вики Дополнительные API методы
Редактировал(а) Андрей Калиновский 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 |