<
From version < 49.1 >
edited by Илья Крайнов
on 2022/11/21 11:03
To version < 66.8 >
edited by Илья Крайнов
on 2022/11/24 13:33
>
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -1,36 +1,32 @@
1 1  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
2 -== Описание ГЛОНАССSoft Public API 3.0 ==
2 += Описание ГЛОНАССSoft Public API 3.0 =
3 3  
4 -== ==
5 5  
6 -[[ (% style="color:#000000; line-height:100%" %)**Авторизация **(% style="color:#000000" %)**— **(% lang="en-US" %)**POST /api/v3/auth/login**>>Авторизация — POST /api/v3/auth/login||anchor="Авторизация — POST /api/v3/auth/login"]]
5 +{{toc/}}
7 7  
8 8  
8 += (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) =
9 9  
10 -
11 -(% class="box" style="text-align: center;" %)
12 -(((
13 -(% style="color:#000000; font-size:18.6667px" %)**Действующие ограничения**
14 -)))
15 -
16 16  (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов).
17 17  
18 18  (% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__).
19 19  
20 20  Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.
21 -
22 22  
23 -(% class="box" style="text-align: center;" %)
24 -(((
25 -(% style="color:#000000; font-size:14pt" %)**Раздел Авторизация**
26 -)))
16 +(% style="color:#000000" %)− (%%)При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
27 27  
28 -(% class="box successmessage" %)
18 +
19 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) =
20 +
21 +
22 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) ==
23 +
24 +(% class="box infomessage" %)
29 29  (((
30 - (% style="color:#000000; line-height:100%" %)**Авторизация **(% style="color:#000000" %)**— **(% lang="en-US" %)**POST /api/v3/auth/login**
26 +(% lang="en-US" %)**POST /api/v3/auth/login**
31 31  )))
32 32  
33 -(% style="color:#000000" %) Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль.
29 +(% style="color:#000000" %)Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль.
34 34  
35 35  (% style="color:#000000" %)Метод запроса: **POST**
36 36  
... ... @@ -60,13 +60,14 @@
60 60  
61 61  **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.
62 62  
59 +== (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) ==
63 63  
64 64  (% class="box infomessage" %)
65 65  (((
66 -(% style="color:#000000; line-height:100%" %)**Проверка авторизации **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/auth/check**
63 +(% lang="en-US" %)**GET /api/v3/auth/check**
67 67  )))
68 68  
69 -(% style="color:#000000" %) Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
66 +(% style="color:#000000" %)Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
70 70  
71 71  (% style="color:#000000" %)Метод запроса: **GET**
72 72  
... ... @@ -77,18 +77,16 @@
77 77  (% lang="en-US" %)
78 78  (% style="color:#000000" %)**Ответ: В случае если сессия активна HTTP ответ «200». В случае если сессия разорвана HTTP ответ «401».**
79 79  
77 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Клиенты**(%%) =
80 80  
81 -(% class="box" style="text-align: center;" %)
82 -(((
83 -(% style="color:#000000; font-size:14pt" %)**Раздел Клиенты**
84 -)))
79 +== (% style="color:#000000; font-size:16px" %)**Получение основных параметров клиента**(%%) ==
85 85  
86 86  (% class="box infomessage" %)
87 87  (((
88 -(% style="color:#000000" %)**Получение основных параметров клиента — **(% lang="en-US" %)**GET **(%%)**/(% lang="en-US" %)api/v3/agents(%%)**
83 +(% lang="en-US" %)**GET **(%%)**/(% lang="en-US" %)api/v3/agents(%%)**
89 89  )))
90 90  
91 -(% style="color:#000000" %) Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
86 +(% style="color:#000000" %)Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
92 92  
93 93  (% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»;
94 94  
... ... @@ -116,17 +116,163 @@
116 116  }
117 117  
118 118  
119 -(% class="box" style="text-align: center;" %)
114 +== (% style="color:#000000, font-size:14px" %)**Добавление клиента**(%%) ==
115 +
116 +(% class="box successmessage" %)
120 120  (((
121 -(% style="color:#000000; font-size:14pt" %)**Раздел Пользователи**
118 +**POST /api/v3/agents **
122 122  )))
123 123  
121 +Метод позволяет добавить клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
122 +
123 +Метод запроса: **POST**
124 +
125 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
126 +
127 +В заголовках запроса: X-Auth: Токен авторизации
128 +
129 +Параметры в теле запроса (JSON):
130 +
131 +{
132 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
133 + "name": "string", ~/~/ имя
134 + "fullName": "string", ~/~/ полное наименование
135 + "isForeign": true, ~/~/ иностранный контрагент
136 + "district": "string", ~/~/ округ
137 + "region": "string", ~/~/ регион
138 + "city": "string", ~/~/ город
139 + "inn": "string", ~/~/ ИНН
140 + "kpp": "string", ~/~/ КПП
141 + "address": "string", ~/~/ юридический адрес
142 + "addressFact": "string", ~/~/ фактический адрес
143 + "email": "string", ~/~/ email
144 + "director": "string", ~/~/ ФИО руководителя
145 + "bankName": "string", ~/~/ банк
146 + "bankBIK": "string", ~/~/ БИК
147 + "bankRS": "string", ~/~/ номер счёта
148 + "bankKS": "string" ~/~/ корр. счёт
149 +}
150 +
151 +
152 +Ответ:
153 +
154 +{
155 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
156 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
157 + "name": "string", ~/~/ имя
158 + "fullName": "string", ~/~/ полное наименование
159 + "isForeign": true, ~/~/ иностранный контрагент
160 + "district": "string", ~/~/ округ
161 + "region": "string", ~/~/ регион
162 + "city": "string", ~/~/ город
163 + "inn": "string", ~/~/ ИНН
164 + "kpp": "string", ~/~/ КПП
165 + "address": "string", ~/~/ юридический адрес
166 + "addressFact": "string", ~/~/ фактический адрес
167 + "email": "string", ~/~/ email
168 + "director": "string", ~/~/ ФИО руководителя
169 + "bankName": "string", ~/~/ банк
170 + "bankBIK": "string", ~/~/ БИК
171 + "bankRS": "string", ~/~/ номер счёта
172 + "bankKS": "string" ~/~/ корр. счёт
173 +}
174 +
175 +
176 +== (% style="color:#000000, font-size:14px" %)**Редактирование клиента**(%%) ==
177 +
178 +(% class="box warningmessage" %)
179 +(((
180 +**PUT /api/v3/agents**
181 +)))
182 +
183 +Метод позволяет отредактировать клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
184 +
185 +Метод запроса: **PUT**
186 +
187 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
188 +
189 +В заголовках запроса: X-Auth: Токен авторизации
190 +
191 +
192 +Параметры в теле запроса (JSON):
193 +
194 +{
195 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
196 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
197 + "name": "string", ~/~/ имя
198 + "fullName": "string", ~/~/ полное наименование
199 + "isForeign": true, ~/~/ иностранный контрагент
200 + "district": "string", ~/~/ округ
201 + "region": "string", ~/~/ регион
202 + "city": "string", ~/~/ город
203 + "inn": "string", ~/~/ ИНН
204 + "kpp": "string", ~/~/ КПП
205 + "address": "string", ~/~/ юридический адрес
206 + "addressFact": "string", ~/~/ фактический адрес
207 + "email": "string", ~/~/ email
208 + "director": "string", ~/~/ ФИО руководителя
209 + "bankName": "string", ~/~/ банк
210 + "bankBIK": "string", ~/~/ БИК
211 + "bankRS": "string", ~/~/ номер счёта
212 + "bankKS": "string" ~/~/ корр. счёт
213 +}
214 +
215 +
216 +Ответ:
217 +
218 +{
219 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
220 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
221 + "name": "string", ~/~/ имя
222 + "fullName": "string", ~/~/ полное наименование
223 + "isForeign": true, ~/~/ иностранный контрагент
224 + "district": "string", ~/~/ округ
225 + "region": "string", ~/~/ регион
226 + "city": "string", ~/~/ город
227 + "inn": "string", ~/~/ ИНН
228 + "kpp": "string", ~/~/ КПП
229 + "address": "string", ~/~/ юридический адрес
230 + "addressFact": "string", ~/~/ фактический адрес
231 + "email": "string", ~/~/ email
232 + "director": "string", ~/~/ ФИО руководителя
233 + "bankName": "string", ~/~/ банк
234 + "bankBIK": "string", ~/~/ БИК
235 + "bankRS": "string", ~/~/ номер счёта
236 + "bankKS": "string" ~/~/ корр. счёт
237 +}
238 +
239 +
240 +== (% style="color:#000000, font-size:14px" %)**Удаление клиента**(%%) ==
241 +
242 +(% class="box errormessage" %)
243 +(((
244 +**DELETE /api/v3/agents/{clientId}**
245 +)))
246 +
247 +Метод позволяет удалить клиента, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
248 +
249 +Метод запроса: **DELETE**
250 +
251 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents/>>https://hosting.glonasssoft.ru/api/v3/agents/]]**{clientId}**
252 +
253 +Параметр запроса: **{clientId}** - Guid пользователя
254 +
255 +В заголовках запроса: X-Auth: Токен авторизации
256 +
257 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
258 +
259 +
260 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) =
261 +
262 +
263 +== (% style="color:#000000; line-height:14px" %)**Добавление пользователя**(%%) ==
264 +
124 124  (% class="box successmessage" %)
125 125  (((
126 -(% style="color:#000000; line-height:100%" %)**Добавление пользователя — **(% lang="en-US" %)**POST /api/v3/users**
267 +(% lang="en-US" %)**POST /api/v3/users**
127 127  )))
128 128  
129 -(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
270 +(% style="color:#000000" %)Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
130 130  
131 131  (% style="color:#000000" %)Метод запроса: **POST**
132 132  
... ... @@ -185,12 +185,14 @@
185 185  (% style="color:#000000; font-weight:normal" %)}
186 186  
187 187  
329 +== (% style="color:#000000; font-size:14px" %)**Получение списка пользователей**(%%) ==
330 +
188 188  (% class="box successmessage" %)
189 189  (((
190 -(% style="color:#000000; line-height:100%" %)**Получение списка пользователей — **(% lang="en-US" %)**POST /api/v3/users/find**
333 +(% lang="en-US" %)**POST /api/v3/users/find**
191 191  )))
192 192  
193 -(% style="color:#000000" %) Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее.
336 +(% style="color:#000000" %)Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее.
194 194  
195 195  (% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«__Просмотр пользователей__»**.
196 196  
... ... @@ -232,12 +232,14 @@
232 232  (% style="color:#000000" %)}
233 233  
234 234  
378 +== (% style="color:#000000; font-size:14px" %)**Получение информации о пользователе**(%%) ==
379 +
235 235  (% class="box successmessage" %)
236 236  (((
237 -(% style="color:#000000; line-height:100%" %)**Получение информации о пользователе — **(% lang="en-US" %)**GET /api/v3/users/{GUID}**
382 +(% lang="en-US" %)**GET /api/v3/users/{GUID}**
238 238  )))
239 239  
240 -(% style="color:#000000" %) Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователе предоставляется при наличии права **«__Просмотр пользователей__»**.
385 +(% style="color:#000000" %)Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователе предоставляется при наличии права **«__Просмотр пользователей__»**.
241 241  
242 242  (% style="color:#000000" %)Метод запроса: **GET**
243 243  
... ... @@ -280,12 +280,14 @@
280 280  )))
281 281  
282 282  
428 +== (% style="color:#000000; font-size:14px" %)**Редактирование пользователя**(%%) ==
429 +
283 283  (% class="box warningmessage" %)
284 284  (((
285 -(% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users**
432 +(% lang="en-US" %)**PUT /api/v3/users**
286 286  )))
287 287  
288 -(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
435 +(% style="color:#000000" %)Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
289 289  
290 290  (% style="color:#000000" %)Метод запроса: **PUT**
291 291  
... ... @@ -293,8 +293,6 @@
293 293  
294 294  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
295 295  
296 -**При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!**
297 -
298 298  (% lang="en-US" style="text-align:left" %)
299 299  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):
300 300  
... ... @@ -353,12 +353,14 @@
353 353  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
354 354  
355 355  
501 +== (% style="color:#000000, font-size:14px" %)**Изменение статуса пользователя**(%%) ==
502 +
356 356  (% class="box warningmessage" %)
357 357  (((
358 -(% style="color:#000000" %)**Изменение статуса пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}**
505 +(% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/users/status/{id}**
359 359  )))
360 360  
361 -(% style="color:#000000" %) Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
508 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
362 362  
363 363  (% style="color:#000000" %)Метод запроса: **PUT**
364 364  
... ... @@ -382,9 +382,11 @@
382 382  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
383 383  
384 384  
532 +== (% style="color:#000000, font-size:14px" %)**Блокировка пользователей**(%%) ==
533 +
385 385  (% class="box warningmessage" %)
386 386  (((
387 -**Блокировка пользователей** (% style="color:#000000; line-height:100%" %)**— POST /api/v3/users/disable**
536 +**POST /api/v3/users/disable**
388 388  )))
389 389  
390 390  Метода позволяет выполнить массовую блокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
... ... @@ -403,9 +403,11 @@
403 403  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
404 404  
405 405  
555 +== (% style="color:#000000, font-size:14px" %)**Разблокировка пользователей**(%%) ==
556 +
406 406  (% class="box warningmessage" %)
407 407  (((
408 -**Разблокировка пользователей** (% style="color:#000000; line-height:100%" %)**— POST /api/v3/users/enable**
559 +**POST /api/v3/users/enable**
409 409  )))
410 410  
411 411  Метода позволяет выполнить массовую разблокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
... ... @@ -437,14 +437,16 @@
437 437  \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями.
438 438  "users" - массив id пользователей, которых не удалось включить или отключить.
439 439  
591 +
592 +== (% style="color:#000000; line-height:14px" %)**Удаление пользователя**(%%) ==
440 440  )))
441 441  
442 442  (% class="box errormessage" %)
443 443  (((
444 -(% style="color:#000000; line-height:100%" %)**Удаление пользователя — **(% lang="en-US" %)**DELETE /api/v3/users/{id}**
597 +(% lang="en-US" %)**DELETE /api/v3/users/{id}**
445 445  )))
446 446  
447 -(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
600 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
448 448  
449 449  (% style="color:#000000" %)Метод запроса: **DELETE**
450 450  
... ... @@ -458,19 +458,19 @@
458 458  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
459 459  
460 460  
461 -(% class="box" style="text-align: center;" %)
462 -(((
463 -(% style="color:#000000; font-size:14pt" %)**Раздел Транспортные средства**
464 -)))
614 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) =
465 465  
616 +
617 +== (% style="color:#000000; font-size:14px" %)**Получение информации об объекте**(%%) ==
618 +
466 466  (% class="box infomessage" %)
467 467  (((
468 -(% style="color:#000000; line-height:100%" %)**Получение информации об объекте — **(% lang="en-US" %)**GET /api/v3/vehicles/{vehicleId}**
621 +(% lang="en-US" %)**GET /api/v3/vehicles/{vehicleId}**
469 469  )))
470 470  
471 -(% style="color:#000000" %) Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение».
624 +(% style="color:#000000" %)Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение».
472 472  
473 -(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
626 +(% style="color:#000000" %)Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
474 474  
475 475  (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов;
476 476  
... ... @@ -532,12 +532,14 @@
532 532  0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
533 533  
534 534  
688 +== (% style="color:#000000; font-size:14px" %)**Добавление объекта**(%%) ==
689 +
535 535  (% class="box successmessage" %)
536 536  (((
537 -(% style="color:#000000; line-height:100%" %)**Добавление объекта — **(% lang="en-US" %)**POST /api/v3/vehicles**
692 +(% lang="en-US" %)**POST /api/v3/vehicles**
538 538  )))
539 539  
540 -(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__).
695 +(% style="color:#000000" %)Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__).
541 541  
542 542  (% style="color:#000000" %)Метод запроса: **POST**
543 543  
... ... @@ -651,14 +651,16 @@
651 651  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
652 652  
653 653  
809 +== (% style="color:#000000; font-size:14px" %)**Получение параметров объектов**(%%) ==
810 +
654 654  (% class="box successmessage" %)
655 655  (((
656 -(% style="color:#000000; line-height:100%" %)**Получение параметров объектов — **(% lang="en-US" %)**POST /api/v3/vehicles/find**
813 +(% lang="en-US" %)**POST /api/v3/vehicles/find**
657 657  )))
658 658  
659 -(% style="color:#000000" %) Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).
816 +(% style="color:#000000" %)Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).
660 660  
661 -(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
818 +(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
662 662  
663 663  (% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов;
664 664  
... ... @@ -695,7 +695,7 @@
695 695   "customFields": null ~/~/ значение любого из произвольных полей ТС
696 696  }
697 697  
698 -(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
855 +(% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
699 699  
700 700  (% style="color:#000000" %)Ответ:
701 701  
... ... @@ -732,12 +732,14 @@
732 732  (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
733 733  
734 734  
892 +== (% style="color:#000000; font-size:14px" %)**Изменение статуса объекта**(%%) ==
893 +
735 735  (% class="box successmessage" %)
736 736  (((
737 -(% style="color:#000000; line-height:100%" %)**Изменение статуса объекта — **(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}**
896 +(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}**
738 738  )))
739 739  
740 -(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
899 +(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
741 741  
742 742  (% style="color:#000000" %)Метод запроса: **POST**
743 743  
... ... @@ -777,12 +777,14 @@
777 777  (% style="color:#000000" %) }
778 778  
779 779  
939 +== (% style="color:#000000; font-size:14px" %)**Редактирование объекта**(%%) ==
940 +
780 780  (% class="box warningmessage" %)
781 781  (((
782 -(% style="color:#000000; line-height:100%" %)**Редактирование объекта — **(% lang="en-US" %)**PUT /api/v3/vehicles**
943 +(% lang="en-US" %)**PUT /api/v3/vehicles**
783 783  )))
784 784  
785 -(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
946 +(% style="color:#000000" %)Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
786 786  
787 787  (% style="color:#000000" %)Метод запроса: **PUT**
788 788  
... ... @@ -905,12 +905,14 @@
905 905  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
906 906  
907 907  
1069 +== (% style="color:#000000; font-size:14px" %)**Удаление объекта**(%%) ==
1070 +
908 908  (% class="box errormessage" %)
909 909  (((
910 -(% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**
1073 +(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**
911 911  )))
912 912  
913 -(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
1076 +(% style="color:#000000" %)Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
914 914  
915 915  (% style="color:#000000" %)Метод запроса: **DELETE**
916 916  
... ... @@ -924,17 +924,17 @@
924 924  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
925 925  
926 926  
927 -(% class="box" lang="en-US" style="text-align: center;" %)
928 -(((
929 -(% style="color:#000000; font-size:14pt" %)**Раздел Устройства**
930 -)))
1090 +(% style="color:#000000; font-size:14pt" %)Раздел: **Устройства**
931 931  
1092 +
1093 +== (% style="color:#000000; font-size:14px" %)**Получение списка типов устройств**(%%) ==
1094 +
932 932  (% class="box infomessage" %)
933 933  (((
934 -(% style="color:#000000; line-height:100%" %)**Получение списка типов устройств **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/devices/types**
1097 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/devices/types**
935 935  )))
936 936  
937 -(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
1100 +(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
938 938  
939 939  (% style="color:#000000" %)Метод запроса: **GET**
940 940  
... ... @@ -953,17 +953,17 @@
953 953  (% style="color:#000000" %)}
954 954  
955 955  
956 -(% class="box" style="text-align: center;" %)
957 -(((
958 -(% style="color:#000000; font-size:14pt" %)**Раздел Датчики**
959 -)))
1119 += (% style="color:#000000; font-size:18.6667pt" %)Раздел: **Датчики**(%%) =
960 960  
1121 +
1122 +== (% style="color:#000000; font-size:14px" %)**Получение списка типов датчиков**(%%) ==
1123 +
961 961  (% class="box infomessage" %)
962 962  (((
963 -(% style="color:#000000; line-height:100%" %)**Получение списка типов датчиков **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/sensors/types**
1126 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types**
964 964  )))
965 965  
966 -(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
1129 +(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
967 967  
968 968  (% style="color:#000000" %)Метод запроса: **GET**
969 969  

Меню

ГЛОНАССSoft wiki - 2024 г.