Last modified by Андрей Калиновский on 2025/02/25 16:35
<
From version < 47.1 >
edited by Илья Крайнов
on 2022/11/21 10:32
To version < 56.2 >
edited by Илья Крайнов
on 2022/11/24 11:28
>
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -1,12 +1,11 @@
1 1  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
2 2  == Описание ГЛОНАССSoft Public API 3.0 ==
3 3  
4 -== ==
5 5  
6 -(% class="box" style="text-align: center;" %)
7 -(((
5 +{{toc/}}
6 +
7 +
8 8  (% style="color:#000000; font-size:18.6667px" %)**Действующие ограничения**
9 -)))
10 10  
11 11  (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов).
12 12  
... ... @@ -111,6 +111,148 @@
111 111  }
112 112  
113 113  
113 +(% class="box successmessage" %)
114 +(((
115 +**Добавление клиента — POST /api/v3/agents **
116 +)))
117 +
118 +Метод позволяет добавить клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
119 +
120 +Метод запроса: **POST**
121 +
122 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
123 +
124 +В заголовках запроса: X-Auth: Токен авторизации
125 +
126 +Параметры в теле запроса (JSON):
127 +
128 +{
129 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
130 + "name": "string", ~/~/ имя
131 + "fullName": "string", ~/~/ полное наименование
132 + "isForeign": true, ~/~/ иностранный контрагент
133 + "district": "string", ~/~/ округ
134 + "region": "string", ~/~/ регион
135 + "city": "string", ~/~/ город
136 + "inn": "string", ~/~/ ИНН
137 + "kpp": "string", ~/~/ КПП
138 + "address": "string", ~/~/ юридический адрес
139 + "addressFact": "string", ~/~/ фактический адрес
140 + "email": "string", ~/~/ email
141 + "director": "string", ~/~/ ФИО руководителя
142 + "bankName": "string", ~/~/ банк
143 + "bankBIK": "string", ~/~/ БИК
144 + "bankRS": "string", ~/~/ номер счёта
145 + "bankKS": "string" ~/~/ корр. счёт
146 +}
147 +
148 +
149 +Ответ:
150 +
151 +{
152 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
153 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
154 + "name": "string", ~/~/ имя
155 + "fullName": "string", ~/~/ полное наименование
156 + "isForeign": true, ~/~/ иностранный контрагент
157 + "district": "string", ~/~/ округ
158 + "region": "string", ~/~/ регион
159 + "city": "string", ~/~/ город
160 + "inn": "string", ~/~/ ИНН
161 + "kpp": "string", ~/~/ КПП
162 + "address": "string", ~/~/ юридический адрес
163 + "addressFact": "string", ~/~/ фактический адрес
164 + "email": "string", ~/~/ email
165 + "director": "string", ~/~/ ФИО руководителя
166 + "bankName": "string", ~/~/ банк
167 + "bankBIK": "string", ~/~/ БИК
168 + "bankRS": "string", ~/~/ номер счёта
169 + "bankKS": "string" ~/~/ корр. счёт
170 +}
171 +
172 +
173 +(% class="box warningmessage" %)
174 +(((
175 +**Редактирование клиента — PUT /api/v3/agents**
176 +)))
177 +
178 +Метод позволяет отредактировать клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
179 +
180 +Метод запроса: **PUT**
181 +
182 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
183 +
184 +В заголовках запроса: X-Auth: Токен авторизации
185 +
186 +
187 +Параметры в теле запроса (JSON):
188 +
189 +{
190 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
191 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
192 + "name": "string", ~/~/ имя
193 + "fullName": "string", ~/~/ полное наименование
194 + "isForeign": true, ~/~/ иностранный контрагент
195 + "district": "string", ~/~/ округ
196 + "region": "string", ~/~/ регион
197 + "city": "string", ~/~/ город
198 + "inn": "string", ~/~/ ИНН
199 + "kpp": "string", ~/~/ КПП
200 + "address": "string", ~/~/ юридический адрес
201 + "addressFact": "string", ~/~/ фактический адрес
202 + "email": "string", ~/~/ email
203 + "director": "string", ~/~/ ФИО руководителя
204 + "bankName": "string", ~/~/ банк
205 + "bankBIK": "string", ~/~/ БИК
206 + "bankRS": "string", ~/~/ номер счёта
207 + "bankKS": "string" ~/~/ корр. счёт
208 +}
209 +
210 +
211 +Ответ:
212 +
213 +{
214 + "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
215 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 
216 + "name": "string", ~/~/ имя
217 + "fullName": "string", ~/~/ полное наименование
218 + "isForeign": true, ~/~/ иностранный контрагент
219 + "district": "string", ~/~/ округ
220 + "region": "string", ~/~/ регион
221 + "city": "string", ~/~/ город
222 + "inn": "string", ~/~/ ИНН
223 + "kpp": "string", ~/~/ КПП
224 + "address": "string", ~/~/ юридический адрес
225 + "addressFact": "string", ~/~/ фактический адрес
226 + "email": "string", ~/~/ email
227 + "director": "string", ~/~/ ФИО руководителя
228 + "bankName": "string", ~/~/ банк
229 + "bankBIK": "string", ~/~/ БИК
230 + "bankRS": "string", ~/~/ номер счёта
231 + "bankKS": "string" ~/~/ корр. счёт
232 +}
233 +
234 +
235 +(% class="box errormessage" %)
236 +(((
237 +**Удаление клиента — DELETE /api/v3/agents/{clientId}**
238 +)))
239 +
240 +
241 +Метод позволяет удалить клиента, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
242 +
243 +Метод запроса: **DELETE**
244 +
245 +URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents/>>https://hosting.glonasssoft.ru/api/v3/agents/]]**{clientId}**
246 +
247 +Параметр запроса: **{clientId}** - Guid пользователя
248 +
249 +В заголовках запроса: X-Auth: Токен авторизации
250 +
251 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
252 +
253 +
254 +
114 114  (% class="box" style="text-align: center;" %)
115 115  (((
116 116  (% style="color:#000000; font-size:14pt" %)**Раздел Пользователи**
... ... @@ -712,7 +712,16 @@
712 712   "status": "" ~/~/ статус объекта         (%%)(-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 
713 713   ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 
714 714   ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)
715 -(% style="color:#000000" %) "createdAt": "" ~/~/ дата создания объектов  (%%)
856 +(% style="color:#000000" %) "createdAt": "" ~/~/ дата создания объектов  
857 + "customFields": [ 
858 + {
859 + "id": "", ~/~/ идентификатор произвольного поля
860 + "name": "", ~/~/ имя произвольного поля
861 + "value": "", ~/~/ значение произвольного поля
862 + "forClient": true, ~/~/ право на отображение у клиента
863 + "forTooltip": false, ~/~/ право на отображение в подсказке
864 + "forReport": false ~/~/ право на отображение в отчетах
865 + }(%%)
716 716  (% style="color:#000000" %)}
717 717  
718 718  (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.

Меню

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