Методы API для работы с ГЛОНАССSoft

1

(% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)

2

(((

3

**Содержание страницы:**

)))

= (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) =

10

11

(% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов).

12

13

(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__).

14

15

Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.

16

17

(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!

18

19

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) =

20

21

== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) ==

22

23

(% class="box successmessage" %)

24

(((

25

(% lang="en-US" %)**POST /api/v3/auth/login**

26

)))

27

28

(% style="color:#000000" %)Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль.

29

30

(% style="color:#000000" %)Метод запроса: **POST**

31

32

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login>>https://hosting.glonasssoft.ru/api/v3/auth/login]]

33

34

(% style="color:#000000" %)В случае успешного выполнения метода, поле «AuthId» содержит токен авторизации «X-Auth».

35

36

(% style="color:#000000" %)Параметры в теле запроса (JSON):

37

38

(% style="color:#000000" %){

39

"login": "testuser",

40

"password": "testuser"

41

}

42

43

(% style="color:#000000" %)**Ответ:**

44

45

(% lang="en-US" %)

46

(% style="color:#000000" %){

47

48

(% lang="en-US" %)

49

(% style="color:#000000" %) "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации

50

"User": "testuser" , ~/~/ имя пользователя

(% lang="en-US" %)

}

**Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.

56

57

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

58

|(% style="width:215px" %)(% style="color:#000000" %)login|(% style="width:861px" %)Логин пользователя

59

|(% style="width:215px" %)(% style="color:#000000" %)password|(% style="width:861px" %)Пароль пользователя

60

|(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации

61

|(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя

62

63

== (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) ==

64

65

(% class="box infomessage" %)

66

(((

67

(% lang="en-US" %)**GET /api/v3/auth/check**

68

)))

69

70

(% style="color:#000000" %)Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет.

71

72

(% style="color:#000000" %)Метод запроса: **GET**

73

74

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/check>>url:https://hosting.glonasssoft.ru/api/v3/auth/check]]

75

76

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

77

78

(% lang="en-US" %)

79

(% style="color:#000000" %)**Ответ: В случае если сессия активна HTTP ответ «200». В случае если сессия разорвана HTTP ответ «401».**

80

81

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Клиенты**(%%) =

82

83

== (% style="color:#000000; font-size:16px" %)**Получение информации о клиенте**(%%) ==

84

85

(% class="box infomessage" %)

86

(((

87

**GET api/v3/agents/{id}**

88

)))

89

90

Метод позволяет получить параметры выбранного клиента(% style="color:#000000" %): наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе:

91

92

(% style="color:#000000" %)− информация о клиенте предоставляется при наличии права «Просмотр клиентов»;

93

94

(% style="color:#000000" %)Метод запроса: **GET**

95

96

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/agents/{id}

97

98

Запрос должен содержать данные параметра "**agentId**"

99

100

(% style="color:#000000" %)Ответ:

{

"agentId": "", (%%)

"parentId": "",

"parentName": "string",

105

"name": "string",

106

"fullName": "string",

107

"agentInfoType": 0,

108

"isForeign": true/false,

109

"district": "string",

"region": "string",

"city": "string",

"inn": "string",

"kpp": "string",

"address": "string",

"addressFact": "string",

116

"email": "string",

117

"director": "string",

118

"bankName": "string",

"bankBIK": "string",

"bankRS": "string",

"bankKS": "string"

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

125

|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента

126

|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя

127

|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя

128

|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента

129

|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента

130

|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)

131

|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент

132

|(% style="width:215px" %)district|(% style="width:861px" %)Округ

133

|(% style="width:215px" %)region|(% style="width:861px" %)Регион

134

|(% style="width:215px" %)city|(% style="width:861px" %)Город

135

|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента

136

|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента

137

|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес

138

|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес

139

|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта

140

|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя

141

|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк

142

|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК

143

|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета

144

|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет

145

146

== (% style="color:#000000; font-size:16px" %)**Получение параметров дочерних клиентов**(%%) ==

147

148

(% class="box infomessage" %)

149

(((

150

(% lang="en-US" %)**POST **(%%)**/(% lang="en-US" %)api/v3/agents/find(%%)**

151

)))

152

153

(% style="color:#000000" %)Метод позволяет получить параметры всех дочерних клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе:

154

155

(% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»;

156

157

(% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах;

158

159

(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его клиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__».

160

161

(% style="color:#000000" %)Метод запроса: **POST**

162

163

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/agents/find

164

165

(% style="color:#000000" %)Параметр запроса:

166

167

(% style="color:#000000" %){

"parentId": "string"

}

(% style="color:#000000" %)Ответ:

172

173

{

174

"agentId": "",(% style="color:#000000" %) (%%)

175

"parentId": "",

176

"parentName": "string",

177

"name": "string",

178

"fullName": "string",

179

"agentInfoType": 0,

180

(% style="color:#000000" %) "status": "",

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

185

|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента

186

|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя

187

|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя

188

|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента

189

|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента

190

|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)

191

|(% style="width:215px" %)(% style="color:#000000" %)status|(% style="width:861px" %)Статус клиента, 0 - заблокирован, 1 - Активен

192

193

== (% style="color:#000000; font-size:16px" %)**Добавление клиента**(%%) ==

194

195

(% class="box successmessage" %)

196

(((

197

**POST /api/v3/agents **

198

)))

199

200

Метод позволяет добавить клиента, указанного в запросе.

201

202

Метод запроса: **POST**

203

204

URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]

205

206

В заголовках запроса: X-Auth: Токен авторизации

207

208

Параметры в теле запроса (JSON):

209

210

{

211

"parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя

212

"name": "string", ~/~/ имя

213

"fullName": "string", ~/~/ полное наименование

214

"agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)

215

"isForeign": true, ~/~/ иностранный контрагент

216

"district": "string", ~/~/ округ

217

"region": "string", ~/~/ регион

218

"city": "string", ~/~/ город

219

"inn": "string", ~/~/ ИНН

220

"kpp": "string", ~/~/ КПП

221

"address": "string", ~/~/ юридический адрес

222

"addressFact": "string", ~/~/ фактический адрес

223

"email": "string", ~/~/ email

224

"director": "string", ~/~/ ФИО руководителя

225

"bankName": "string", ~/~/ банк

226

"bankBIK": "string", ~/~/ БИК

227

"bankRS": "string", ~/~/ номер счёта

228

"bankKS": "string" ~/~/ корр. счёт

}

Ответ:

{

"agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента

236

"parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя

237

"name": "string", ~/~/ имя

238

"fullName": "string", ~/~/ полное наименование

239

"agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)

240

"isForeign": true, ~/~/ иностранный контрагент

241

"district": "string", ~/~/ округ

242

"region": "string", ~/~/ регион

243

"city": "string", ~/~/ город

244

"inn": "string", ~/~/ ИНН

245

"kpp": "string", ~/~/ КПП

246

"address": "string", ~/~/ юридический адрес

247

"addressFact": "string", ~/~/ фактический адрес

248

"email": "string", ~/~/ email

249

"director": "string", ~/~/ ФИО руководителя

250

"bankName": "string", ~/~/ банк

251

"bankBIK": "string", ~/~/ БИК

252

"bankRS": "string", ~/~/ номер счёта

253

"bankKS": "string" ~/~/ корр. счёт

254

}

255

256

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

257

|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента

258

|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя

259

|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя

260

|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента

261

|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента

262

|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)

263

|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент

264

|(% style="width:215px" %)district|(% style="width:861px" %)Округ

265

|(% style="width:215px" %)region|(% style="width:861px" %)Регион

266

|(% style="width:215px" %)city|(% style="width:861px" %)Город

267

|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента

268

|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента

269

|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес

270

|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес

271

|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта

272

|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя

273

|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк

274

|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК

275

|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета

276

|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет

277

278

== (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) ==

279

280

(% class="box warningmessage" %)

281

(((

282

**PUT /api/v3/agents**

283

)))

284

285

Метод позволяет отредактировать клиента, указанного в запросе.

286

287

Метод запроса: **PUT**

288

289

URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]

290

291

В заголовках запроса: X-Auth: Токен авторизации

292

293

Параметры в теле запроса (JSON):

294

295

{

296

"agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента

297

"parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя

298

"name": "string", ~/~/ имя

299

"fullName": "string", ~/~/ полное наименование

300

"agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)

301

"isForeign": true, ~/~/ иностранный контрагент

302

"district": "string", ~/~/ округ

303

"region": "string", ~/~/ регион

304

"city": "string", ~/~/ город

305

"inn": "string", ~/~/ ИНН

306

"kpp": "string", ~/~/ КПП

307

"address": "string", ~/~/ юридический адрес

308

"addressFact": "string", ~/~/ фактический адрес

309

"email": "string", ~/~/ email

310

"director": "string", ~/~/ ФИО руководителя

311

"bankName": "string", ~/~/ банк

312

"bankBIK": "string", ~/~/ БИК

313

"bankRS": "string", ~/~/ номер счёта

314

"bankKS": "string" ~/~/ корр. счёт

}

Ответ:

{

"agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента

321

"parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя

322

"name": "string", ~/~/ имя

323

"fullName": "string", ~/~/ полное наименование

324

"isForeign": true, ~/~/ иностранный контрагент

325

"district": "string", ~/~/ округ

326

"region": "string", ~/~/ регион

327

"city": "string", ~/~/ город

328

"inn": "string", ~/~/ ИНН

329

"kpp": "string", ~/~/ КПП

330

"address": "string", ~/~/ юридический адрес

331

"addressFact": "string", ~/~/ фактический адрес

332

"email": "string", ~/~/ email

333

"director": "string", ~/~/ ФИО руководителя

334

"bankName": "string", ~/~/ банк

335

"bankBIK": "string", ~/~/ БИК

336

"bankRS": "string", ~/~/ номер счёта

337

"bankKS": "string" ~/~/ корр. счёт

338

}

339

340

== (% style="color:#000000; font-size:16px" %)**Удаление клиента**(%%) ==

341

342

(% class="box errormessage" %)

343

(((

344

**DELETE /api/v3/agents/{clientId}**

345

)))

346

347

Метод позволяет удалить клиента, указанного в строке запроса.

348

349

Метод запроса: **DELETE**

350

351

URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents/>>https://hosting.glonasssoft.ru/api/v3/agents/]]**{clientId}**

352

353

Параметр запроса: **{clientId}** - Guid пользователя

354

355

В заголовках запроса: X-Auth: Токен авторизации

356

357

Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».

358

359

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) =

360

361

== (% style="color:#000000; font-size:16px" %)**Добавление пользователя**(%%) ==

362

363

(% class="box successmessage" %)

364

(((

365

(% lang="en-US" %)**POST /api/v3/users**

366

)))

367

368

(% style="color:#000000" %)Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе.

369

370

(% style="color:#000000" %)Метод запроса: **POST**

371

372

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users>>url:https://hosting.glonasssoft.ru/api/v3/users]]

373

374

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

375

376

(% style="color:#000000" %)Параметры в теле запроса (JSON):

377

378

(% style="color:#000000" %)

379

{

380

"lastName": "", ~/~/ фамилия

381

"firstName": "", ~/~/ имя

382

"position": "", ~/~/ должность

383

"phone": "", ~/~/ телефон

384

"organization": "", ~/~/ организация

385

"login": "", ~/~/ логин (обязателен)

386

"password": "", ~/~/ пароль (обязателен)

387

"email": "", ~/~/ email (обязателен)

388

"description": "string", ~/~/ Описание

389

"isReadOnly": true, ~/~/ Право только на чтение, true - включено, false - отключено

390

"isDisabledMobile": true, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен

391

"isEnabled": true, ~/~/ Включен, true - включен, false - отключен

392

"parentId": "", ~/~/ Guid родительского агента

393

"leaderId": "", ~/~/ Guid руководителя (null - не задан)

394

"sessionDuration": 0, ~/~/ продолжительность сессии, в минутах (null - по умолчанию, 30 минут)

395

"doubleAuth":

396

{

397

"kind": 0, ~/~/ Состояние двухэтапной аутентификации, email - включен, None - отключен

398

"target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации

},

"groups":

[

"string" ~/~/ группы пользователя, перечисление названия системных ролей

],

"customGroups":

[

"3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей

407

],

408

"language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский

}

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

413

"lastName": "string",

414

"firstName": "string",

415

"position": "string",

416

"phone": "string",

417

"organization": "string",

418

"login": "string",

419

"password": "string",

420

"email": "string",

421

422

(% style="text-align:left" %)

423

(% style="color:#000000; font-weight:normal" %)Ответ:

424

425

(% style="text-align:left" %)

426

(% style="color:#000000; font-weight:normal" %){

427

428

(% style="text-align:left" %)

429

(% style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя

430

"lastName": "" , ~/~/ Фамилия ,

431

"firstName": "" , ~/~/ Имя

432

"position": "" , ~/~/ Должность

433

"phone": "" , ~/~/ Телефон

434

"organization": "" , ~/~/ Организация

435

"login": "" , ~/~/ Логин

436

"password": "" , ~/~/ Пароль

437

"email": "" , ~/~/ Email

438

"description": "" , ~/~/ Описание

439

"isEnabled": "" , ~/~/ Признак включения

440

"parentId": "" , ~/~/ Guid родительского агента

441

"sessionDuration": "" , ~/~/ Продолжительность сессии, в минутах

442

"doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации

443

"kind": "" , ~/~/ тип аутентификации

444

"target": "" , ~/~/ в случае аутентификации по email - email-адрес

445

"groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя

446

447

(% style="text-align:left" %)

448

(% style="color:#000000; font-weight:normal" %)}

449

450

451

== (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) ==

452

453

(% class="box infomessage" %)

454

(((

455

(% lang="en-US" %)**POST /api/v3/users/find**

456

)))

457

458

(% style="color:#000000" %)Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее.

459

460

(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«__Просмотр пользователей__»**.

461

462

(% style="color:#000000" %)Метод запроса: **POST**

463

464

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]]

465

466

(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса.

467

468

(% style="color:#000000" %)Параметры в теле запроса (JSON):

469

470

(% style="color:#000000" %){

471

472

"parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента

473

"userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно

474

"login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно

475

"email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно

476

477

(% style="color:#000000" %)}

478

479

(% style="color:#000000" %)Ответ:

480

481

(% style="color:#000000" %){ (%%)

482

483

"id": "" , ~/~/ идентификатор пользователя

484

"lastName": "" , ~/~/ фамилия

485

"firstName": "" , ~/~/ имя

486

"position": "" , ~/~/ должность

487

"phone": "" , ~/~/ телефон

488

"parentId": "" , ~/~/ идентификатор клиента-родителя

489

"parentName": "" , ~/~/ наименование клиента-родителя

490

"organization": "" , ~/~/ организация

491

"login": "" , ~/~/ логин

492

"email": "" , ~/~/ E-mail

493

"sessionDuration":"", ~/~/ длительность сессии в минутах

494

"status": "1", ~/~/ статус пользователя

495

"lastLogged": "", ~/~/ дата/время последней авторизации

496

497

(% style="color:#000000" %)}

498

499

== (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) ==

500

501

(% class="box infomessage" %)

502

(((

503

(% lang="en-US" %)**GET /api/v3/users/{GUID}**

504

)))

505

506

(% style="color:#000000" %)Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователе предоставляется при наличии права **«__Просмотр пользователей__»**.

507

508

(% style="color:#000000" %)Метод запроса: **GET**

509

510

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/(% lang="en-US" %)users/{GUID}>>https://hosting.glonasssoft.ru/api/v3/users/{GUID}]]

511

512

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

513

514

(% style="color:#000000" %)Ответ:

(((

(((

{

"id": "", ~/~/ GUID пользователя

520

"lastName": "", ~/~/ Фамилия

521

"firstName": "", ~/~/ Имя

522

"position": "", ~/~/ Должность

523

"phone": "", ~/~/ Номер телефона

524

"parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь

525

"parentName": "", Наименование клиента, которому принадлежит пользователь

526

"organization": "", ~/~/ Организация

527

"login": "", ~/~/ Логин пользователя

528

"email": "", ~/~/ Адрес электронной почты

529

"language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский

530

"isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено

531

"description": "", ~/~/ Описание

532

"isEnabled": , ~/~/ Включен, true - включен, false - отключен

533

"doubleAuth":

534

{

535

"kind": "None", ~/~/ Состояние двухэтапной аутентификации, email - включен, None - отключен

536

"target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации

537

},

538

"isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен

539

"sessionDuration": 30, ~/~/ Длительность сессии в минутах

540

"status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован

541

"lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя

542

"groups": [], ~/~/ Список ролей пользователя

543

"customGroups": [], ~/~/ Список клиентских ролей пользователя

544

"authDevices": [ ], ~/~/ Список авторизованных устройств

545

"mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств

546

"pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления

}

)))

)))

== (% style="color:#000000; font-size:16px" %)**Редактирование пользователя**(%%) ==

552

553

(% class="box warningmessage" %)

554

(((

555

(% lang="en-US" %)**PUT /api/v3/users**

556

)))

557

558

(% style="color:#000000" %)Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе.

559

560

(% style="color:#000000" %)Метод запроса: **PUT**

561

562

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users>>url:https://hosting.glonasssoft.ru/api/v3/users]]

563

564

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

565

566

(% lang="en-US" style="text-align:left" %)

567

(% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):

568

569

(% lang="en-US" style="text-align:left" %)

570

(% lang="ru-RU" style="color:#000000; font-weight:normal" %){

571

572

(% lang="en-US" style="text-align:left" %)

573

(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя

574

"lastName": "" , ~/~/ фамилия

575

"firstName": "" , ~/~/ имя

576

"position": "" , ~/~/ должность

577

"phone": "" , ~/~/ телефон

578

"organization": "" , ~/~/ организация

579

"login": "" , ~/~/ логин (% style="color:#000000" %)(Если null - менять не надо)(%%)

580

(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "password": "" , ~/~/ пароль (Если null - менять не надо)

581

"language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский

582

"isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено

583

"email": "" , ~/~/ email (% style="color:#000000" %)(Если null - менять не надо)(%%)

584

(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "description": "" , ~/~/ описание

585

"isEnabled": "" , ~/~/ признак включения

586

"parentId": "" , ~/~/ Guid родительского агента

587

"leaderId": "" , ~/~/ Guid руководителя (null - не задан)

588

"sessionDuration": "" , ~/~/ продолжительность сессии, в минутах (null - по умолчанию, 30 минут)

589

"doubleAuth":

590

{

591

"kind": "None", ~/~/ Состояние двухэтапной аутентификации, email - включен, None - отключен

592

"target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации

593

},

594

"isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен

595

"groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя

596

597

(% lang="en-US" style="text-align:left" %)

598

(% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__

599

600

(% lang="en-US" style="text-align:left" %)

601

(% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~://

602

603

(% lang="en-US" style="text-align:left" %)

604

(% lang="ru-RU" style="color:#000000; font-weight:normal" %){

605

606

(% lang="en-US" style="text-align:left" %)

607

(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя

608

"lastName": "" , ~/~/ фамилия

609

"firstName": "" , ~/~/ имя

610

"position": "" , ~/~/ должность

611

"phone": "" , ~/~/ телефон

612

"organization": "" , ~/~/ организация

613

"login": "" , ~/~/ логин

614

"password": "" , ~/~/ пароль

615

"email": "" , ~/~/ email

616

"description": "" , ~/~/ описание

617

"isEnabled": "" , ~/~/ признак включения

618

"parentId": "" , ~/~/ Guid родительского агента

619

"sessionDuration": "" , ~/~/ продолжительность сессии, в минутах

620

"doubleAuth":

621

{

622

"kind": "None", ~/~/ Состояние двухэтапной аутентификации, email - включен, None - отключен

623

"target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации

624

},

625

"isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен

626

"target": "" , ~/~/ в случае аутентификации по email - email-адрес

627

"groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя

628

629

(% lang="en-US" style="text-align:left" %)

630

(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}

631

632

== (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) ==

633

634

(% class="box warningmessage" %)

635

(((

636

(% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/users/status/{id}**

637

)))

638

639

(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе.

640

641

(% style="color:#000000" %)Метод запроса: **PUT**

642

643

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/status/>>url:https://hosting.glonasssoft.ru/api/v3/users/status/]](% style="color:#000000" %){id}

644

645

(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid пользователя

646

647

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

648

649

(% style="color:#000000" %)Параметры в теле запроса (JSON):

650

651

(% style="color:#000000" %){

652

653

"status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован)

654

"description": "" , ~/~/ описание

655

"data": "" , ~/~/ данные, связанные со сменой статуса

656

657

(% style="color:#000000" %)}

658

659

(% style="text-align:left" %)

660

(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**

661

662

== (% style="color:#000000; font-size:16px" %)**Блокировка пользователей**(%%) ==

663

664

(% class="box warningmessage" %)

665

(((

666

**POST /api/v3/users/disable**

667

)))

668

669

Метода позволяет выполнить массовую блокировку пользователей(% style="color:#000000" %).

670

671

(% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST**

672

673

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/disable>>https://hosting.glonasssoft.ru/api/v3/users/disable]]

674

675

(% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON):

676

677

[

678

"8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",

679

"415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1"

680

]

681

682

(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**

683

684

== (% style="color:#000000; font-size:16px" %)**Разблокировка пользователей**(%%) ==

685

686

(% class="box warningmessage" %)

687

(((

688

**POST /api/v3/users/enable**

689

)))

690

691

Метода позволяет выполнить массовую разблокировку пользователей(% style="color:#000000" %).

692

693

(% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST**

694

695

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/enable>>https://hosting.glonasssoft.ru/api/v3/users/enable]]

696

697

(% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON):

698

699

[

700

"8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",

701

"415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1"

702

]

703

704

(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**(%%)

705

\\(% style="color:#000000" %)__Для двух, описанных выше, методов если не получилось выполнить включение или отключение некоторых пользователей из переданного списка возвращается ответ - 206 Partial Content__

(((

В теле ответа:

{

"errorMessages": [

"Agent 0f8c2a8b-4b71-48d0-b780-341053089874 cannot access to object Agents d493fd88-60c8-465d-afad-912f5ac9d719."

712

],

713

"users": [

714

"415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1"

715

]

716

}

717

\\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями.

718

"users" - массив id пользователей, которых не удалось включить или отключить.

719

)))

720

721

== (% style="color:#000000; font-size:16px" %)**Удаление пользователя**(%%) ==

722

723

(% class="box errormessage" %)

724

(((

725

(% lang="en-US" %)**DELETE /api/v3/users/{id}**

726

)))

727

728

(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса.

729

730

(% style="color:#000000" %)Метод запроса: **DELETE**

731

732

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/>>url:https://hosting.glonasssoft.ru/api/v3/users/]](% style="color:#000000" %){id}

733

734

(% style="color:#000000" %)Параметр запроса: {**__id__**} - Guid пользователя

735

736

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

737

738

(% style="text-align:left" %)

739

(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**

740

741

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) =

742

743

== (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) ==

744

745

(% class="box infomessage" %)

746

(((

747

(% lang="en-US" %)**GET /api/v3/models/{Id}**

748

)))

749

750

Метод возвращает полную информацию о модели объекта.

751

752

(% style="color:#000000" %)Метод запроса: **GET**

753

754

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/(% lang="en-US" %)v3/models/(% style="color:#000000" %){(%%)ID}

755

756

(% style="color:#000000" %)Параметр запроса: {__**id}**__ - идентификатор модели объекта

757

758

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

759

760

(% style="color:#000000" %)Ответ:

761

762

(% style="color:#000000" %){

763

"parentName": "string",

"name": "string",

"picture": "string",

"minspeed": 0,

"maxspeed": 0,

"width": 0,

"imbeddedtrailer": true,

770

"hoppercapacity": 0,

771

"hopperdischargespeed": 0,

772

"modelType": 0,

773

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

774

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

779

|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта

780

|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта

781

|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта

782

|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч

783

|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч

784

|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах

785

|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат

786

|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера

787

|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость2 выгрузки из бункера, л/сек

788

|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car

789

|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта

790

|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта

791

|(% style="width:215px" %)(% style="color:#000000" %)deleted|(% style="width:861px" %)Признак удаления, тип: boolean

792

793

== (% style="color:#000000; font-size:16px" %)**Просмотр списка моделей**(%%) ==

794

795

(% class="box successmessage" %)

796

(((

797

(% lang="en-US" %)**POST /api/v3/models/find**

798

)))

799

800

(% style="color:#000000" %)Метод позволяет получить список всех моделей клиента, указанного в запросе.

801

802

(% style="color:#000000" %)Метод запроса: **POST**

803

804

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/models/find

805

806

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

807

808

(% style="color:#000000" %)Параметры в теле запроса (JSON):{

809

810

(% style="color:#000000" %) "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

811

}

812

813

(% style="color:#000000" %)Ответ:

814

815

(% style="color:#000000" %)[

816

{

817

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

818

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

819

"parentName": "string",

"name": "string",

"modelType": 0

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

826

|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта

827

|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта

828

|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car

829

|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта

830

|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта

831

832

== (% style="color:#000000; font-size:16px" %)**Добавление модели**(%%) ==

833

834

(% class="box successmessage" %)

835

(((

836

(% lang="en-US" %)**POST /api/v3/models**

837

)))

838

839

(% style="color:#000000" %)Метод позволяет добавить объект, указанный в запросе.

840

841

(% style="color:#000000" %)Метод запроса: **POST**

842

843

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/(% lang="en-US" %)models

844

845

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

846

847

(% style="color:#000000" %)Параметры в теле запроса (JSON):

848

849

{

850

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

851

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true,

"extId": "string",

"name": "string",

"picture": "string",

"minspeed": 0,

"maxspeed": 0,

"width": 0,

"imbeddedtrailer": true,

860

"fueloutlay": 0,

861

"hoppercapacity": 0,

862

"hopperdischargespeed": 0,

"modelType": 0

}

Ответ:

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

870

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true,

"extId": "string",

"name": "string",

"picture": "string",

"minspeed": 0,

"maxspeed": 0,

"width": 0,

"imbeddedtrailer": true,

879

"hoppercapacity": 0,

880

"hopperdischargespeed": 0,

"modelType": 0

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

885

|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта

886

|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта

887

|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта

888

|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта

889

|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта

890

|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч

891

|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч

892

|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах

893

|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат

894

|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера

895

|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек

896

|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car

897

898

== (% style="color:#000000; font-size:16px" %)**Редактирование модели**(%%) ==

899

900

(% class="box warningmessage" %)

901

(((

902

(% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models**

903

)))

904

905

(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе.

906

907

(% style="color:#000000" %)Метод запроса: **PUT**

908

909

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/(% lang="en-US" %)api/v3/models

910

911

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

912

913

(% style="color:#000000" %)Параметры в теле запроса (JSON):

914

915

{

916

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

917

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true,

"extId": "string",

"name": "string",

"picture": "string",

"minspeed": 0,

"maxspeed": 0,

"width": 0,

"imbeddedtrailer": true,

926

"fueloutlay": 0,

927

"hoppercapacity": 0,

928

"hopperdischargespeed": 0,

"modelType": 0

}

Ответ:

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

936

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true,

"extId": "string",

"name": "string",

"picture": "string",

"minspeed": 0,

"maxspeed": 0,

"width": 0,

"imbeddedtrailer": true,

945

"fueloutlay": 0,

946

"hoppercapacity": 0,

947

"hopperdischargespeed": 0,

"modelType": 0

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

952

|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта

953

|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта

954

|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта

955

|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта

956

|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта

957

|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч

958

|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч

959

|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах

960

|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат

961

|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера

962

|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек

963

|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car

964

965

== (% style="color:#000000; font-size:16px" %)**Удаление модели**(%%) ==

966

967

(% class="box errormessage" %)

968

(((

969

(% lang="en-US" %)**DELETE /api/v3/models/{Id}**

970

)))

971

972

(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса.

973

974

(% style="color:#000000" %)Метод запроса: **DELETE**

975

976

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru(% lang="en-US" %)/api/v3/models/{Id}

977

978

(% style="color:#000000" %)Параметр запроса: {**__id__**} - id модели

979

980

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

981

982

Ответ: В случае успеха **Success 200**

983

984

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) =

985

986

== (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) ==

987

988

(% class="box infomessage" %)

989

(((

990

(% lang="en-US" %)**GET /api/v3/vehicles/{vehicleId}**

991

)))

992

993

(% style="color:#000000" %)Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение».

994

995

(% style="color:#000000" %)Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе:

996

997

(% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов;

998

999

(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«__Просмотр заданий на техобслуживание__»**.

1000

1001

(% style="color:#000000" %)Метод запроса: **GET**

1002

1003

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){(% lang="en-US" %)v(%%)ehicleID}

1004

1005

(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__ - идентификатор объекта (integer($int32))

1006

1007

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1008

1009

(% style="color:#000000" %)Ответ:

(((

{

"vehicleId": "", ~/~/ ID объекта

1014

"name": "", ~/~/ Имя объекта

1015

"imei": "", ~/~/ IMEI объекта

1016

"deviceTypeId": , ~/~/ ID типа устройства

1017

"deviceTypeName": "", ~/~/ Название типа устройства

1018

"sim1": "", ~/~/ Номер SIM1

1019

"sim2": "", ~/~/ Номер SIM2

1020

1021

"parentId": "", ~/~/ ID клиента-родителя

1022

"parentName": "", ~/~/ Наименование клиента-родителя

1023

"modelId": "", ~/~/ ID модели объекта

1024

"modelName": "", ~/~/ Имя модели объекта

1025

1026

"unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения

1027

"unitName": "string", ~/~/ Наименование подразделения

1028

"status": 0, ~/~/ Статус объекта

1029

1030

"createdAt": "", ~/~/ Дата создания объекта

1031

},

1032

1033

"customFields": [ ~/~/ Произвольные поля

1034

{

1035

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля

1036

"name": "string", ~/~/ Имя поля

1037

"value": "string", ~/~/ Значение поля

1038

"forClient": true, ~/~/ Не используемая функция

1039

"forTooltip": true, ~/~/ Отображать в подсказке

1040

"forReport": true ~/~/ Отображать в отчете

1041

}

1042

1043

], ~/~/ Данные с вкладки нормы

1044

"consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено)

1045

"consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено)

1046

"consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу

1047

"consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км

1048

"consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас

1049

"consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу

1050

"consumptionPer100KmSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км

1051

"consumptionPer100KmSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км

1052

"consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас

1053

"consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас

1054

"consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х

1055

"consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х

1056

1057

"mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания

1058

"mileageCoeff": 0, ~/~/ коэффициент пробега

1059

"locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна

1060

"dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат, true - активна, false - не активна

1061

"counters": { ~/~/ Счетчики

1062

"mileageEnabled": true, ~/~/ Считать текущий пробег, true - активна, false - не активна

1063

"motohoursEnabled": true, ~/~/ Считать текущие моточасы, true - активна, false - не активна

1064

"mileage": 0, ~/~/ Текущий пробег

1065

"motohours": 0, ~/~/ Текущие моточасы

1066

"mileageTime": "2023-05-22T09:57:39.562Z", ~/~/ Дата пересчета последнего пробега

1067

"motohoursTime": "2023-05-22T09:57:39.562Z" ~/~/ Дата пересчета последних моточасов

1068

},

1069

1070

"cmsv6Parameters": { ~/~/ Настройки видеомониторинга

1071

"id": "string", ~/~/ ID объекта

1072

"enabled": true, ~/~/ Включить, true - активна, false - не активна

1073

"host": "string", ~/~/ CMSV6 Web Host

1074

"login": "string", ~/~/ CMSV6 Account

1075

"password": "string" ~/~/ CMSV6 Password

1076

},

1077

1078

"commandTemplates": [ ~/~/ Шаблоны команд

1079

{

1080

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID команды

1081

"name": "string", ~/~/ Наименование команды

1082

"command": "string", ~/~/ Текст команды

1083

"retries": 0 ~/~/ Количество попыток

}

],

"sensors": [ ~/~/ Датчики

1088

{

1089

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика

1090

"kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный

1091

"type": 0, ~/~/ Тип датчика

1092

"name": "string", ~/~/ Имя датчика

1093

"inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE

1094

"inputNumber": 0, ~/~/ Номер входа

1095

"pseudonym": "string", ~/~/ Псевдоним

1096

"medianDegree": 0, ~/~/ Медианная фильтрация

1097

"isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл.

1098

"disabled": true, ~/~/ Состояние: Отключен, true - Вкл., false - Выкл.

1099

"gradeType": 0, ~/~/ Тип тарировки, 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs

1100

"gradesTables": [ ~/~/ Массив таблиц тарировки

1101

{

1102

"grades": [ ~/~/ Таблица тарировки 1

1103

{

1104

"input": 0, ~/~/ Входящее значение

1105

"output": 0 ~/~/ Выходящее значение

1106

}

1107

],

1108

"relevanceTime": "2023-05-22T09:57:39.562Z" ~/~/ Дата/время начала применения тарировочной таблицы

1109

}

1110

],

1111

"showInTooltip": true, ~/~/ Отображать в подсказке

1112

"showLastValid": true, ~/~/ Отображать последнее валидное значение

1113

"showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива

1114

"showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания

1115

"agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION

1116

"expr": "string", ~/~/ Формула

1117

"children": [ ~/~/ массив дочерних датчиков

1118

"string"

1119

],

1120

"customParams": { ~/~/ прочие произвольные параметры

1121

"additionalProp1": "string",

1122

"additionalProp2": "string",

1123

"additionalProp3": "string"

1124

},

1125

1126

~/~/ Характерные для произвольного:

1127

1128

~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off

1129

1130

~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы

1131

1132

~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off

1133

1134

~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний

1135

1136

~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off

1137

1138

~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off

1139

1140

~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off

1141

1142

~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)

1143

1144

~/~/ Характерные для таблицы тарировки Вкл./Выкл.:

1145

1146

~/~/ "ValueOn": "Вкл.",

1147

1148

~/~/ "ValueOff": "Выкл."

1149

"summaryMaxValue": 0 ~/~/ Макс. значение

1150

}

1151

1152

"drivers": [ ~/~/ Водители

1153

{

1154

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

1155

"name": "string", ~/~/ Наименование

1156

"description": "string",

1157

"isDefault": true ~/~/ По умолчанию

}

],

"inspectionTasks": [ ~/~/ Задания на тех. обслуживание

1162

{

1163

"id": "", ~/~/ ID задания

1164

"enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен)

1165

"name": "", ~/~/ Наименование задания

1166

"description": "", ~/~/ Описание задания

1167

"mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает)

1168

"lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)

1169

"motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает)

1170

"lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)

1171

"periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)

1172

"kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает)

1173

"lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано)

1174

"maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)

}

],

"statusHistory": [ ~/~/ История статусов

1179

{

1180

"status": 0,

1181

"date": "2023-05-22T09:57:39.562Z",

1182

"description": "string",

1183

"additionalInfo": "string"

}

]

}

)))

(% style="text-align:left" %)

1191

Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:

1192

1193

(% style="text-align:left" %)

1194

0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».

1195

1196

== (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) ==

1197

1198

(% class="box successmessage" %)

1199

(((

1200

(% lang="en-US" %)**POST /api/v3/vehicles**

1201

)))

1202

1203

(% style="color:#000000" %)Метод позволяет добавить объект, указанный в запросе.

1204

1205

(% style="color:#000000" %)Метод запроса: **POST**

1206

1207

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles>>url:https://hosting.glonasssoft.ru/api/v3/vehicles]]

1208

1209

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1210

1211

(% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON

1212

1213

(% style="color:#000000" %){

1214

1215

"parentId": "" , ~/~/ ID клиента

1216

"name": "" , ~/~/ имя ТС

1217

"imei": "" , ~/~/ IMEI

1218

"deviceTypeId": "" , ~/~/ ID типа устройства

1219

"modelId": "" , ~/~/ ID модели

1220

"unitId": "" , ~/~/ ID подразделения

1221

"sim1": "" , ~/~/ Номер SIM 1

1222

"sim2": "" , ~/~/ Номер SIM2

1223

"consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено)

1224

"consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено)

1225

"consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу

1226

"consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км

1227

"consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас

1228

"consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу

1229

"consumptionPer100KmSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км

1230

"consumptionPer100KmSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км

1231

"consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас

1232

"consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас

1233

"consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х

1234

"consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х

1235

1236

"mileageCalcMethod": 0,

1237

"mileageCoeff": 0,

1238

"locationByCellId": true,

1239

"dottedLineTrackWhenNoCoords": true,

1240

"counters": ~/~/ счетчики

1241

{

1242

"mileage": "" , ~/~/ пробег

1243

"mileageEnabled": true, ~/~/ флаг активности счётчика "пробег"

1244

"motohours": "" , ~/~/ моточасы

1245

"motohoursEnabled": true ~/~/ флаг активности счётчика "моточасы"

1246

},

1247

"cmsv6Parameters": { ~/~/ параметры CMSv6

1248

"enabled": true, ~/~/ флаг включения

1249

"id": "" , ~/~/ идентификатор

1250

"host": "" , ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6

1251

"login": "" , ~/~/ имя учетной записи

1252

"password": "" ~/~/ пароль учетной записи

1253

},

1254

"inspectionTasks": ~/~/ задания на ТО

1255

{

1256

"enabled": "" , ~/~/ Признак включения

1257

"name": "" , ~/~/ Имя задания

1258

"description": "" , ~/~/ Описание задания

1259

"mileageCondition": "" , ~/~/ Условие по пробегу (в метрах, null - условие не работает)

1260

"lastMileage": "" , ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)

1261

"motohoursCondition": "" , ~/~/ Условие по моточасам (в секундах, null - условие не работает)

1262

"lastMotohours": "" , ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)

1263

"periodicCondition": "" , ~/~/ Условие периодичности по времени (null - условие не работает)

1264

"kind": "" , ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает)

1265

"lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано)

1266

"maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)

1267

}

1268

1269

"drivers": [ ~/~/ Водители

1270

{

1271

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"isDefault": true

}

],

"commandTemplates": [ ~/~/ Шаблон команды

1276

{

1277

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"name": "string",

"command": "string",

"retries": 0

}

],

"sensors": [ ~/~/ Датчики

1285

{

1286

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика

1287

"kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный

1288

"type": 0, ~/~/ Тип датчика

1289

"name": "string", ~/~/ Имя датчика

1290

"inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE

1291

"inputNumber": 0, ~/~/ Номер входа

1292

"pseudonym": "string", ~/~/ Псевдоним

1293

"medianDegree": 0, ~/~/ Медианная фильтрация

1294

"isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл.

1295

"disabled": true, ~/~/ Состояние: Отключен, true - Вкл., false - Выкл.

1296

"gradeType": 0, ~/~/ Тип тарировки, 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs

1297

"gradesTables": [ ~/~/ Массив таблиц тарировки

1298

{

1299

"grades": [ ~/~/ Таблица тарировки 1

1300

{

1301

"input": 0, ~/~/ Входящее значение

1302

"output": 0 ~/~/ Выходящее значение

1303

}

1304

],

1305

"relevanceTime": "2023-05-22T09:57:39.562Z" ~/~/ Дата/время начала применения тарировочной таблицы

1306

}

1307

],

1308

"showInTooltip": true, ~/~/ Отображать в подсказке

1309

"showLastValid": true, ~/~/ Отображать последнее валидное значение

1310

"showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива

1311

"showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания

1312

"agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION

1313

"expr": "string", ~/~/ Формула

1314

"children": [ ~/~/ массив дочерних датчиков

1315

"string"

1316

],

1317

"customParams": { ~/~/ прочие произвольные параметры

1318

"additionalProp1": "string",

1319

"additionalProp2": "string",

1320

"additionalProp3": "string"

1321

},

1322

1323

~/~/ Характерные для произвольного:

1324

1325

~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off

1326

1327

~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы

1328

1329

~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off

1330

1331

~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний

1332

1333

~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off

1334

1335

~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off

1336

1337

~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off

1338

1339

~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)

1340

1341

~/~/ Характерные для таблицы тарировки Вкл./Выкл.:

1342

1343

~/~/ "ValueOn": "Вкл.",

1344

1345

~/~/ "ValueOff": "Выкл."

1346

"summaryMaxValue": 0 ~/~/ Макс. значение

1347

}

1348

],

1349

"customFields": [ ~/~/ Произвольные поля

1350

{

1351

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"name": "string",

"value": "string",

"forClient": true,

"forTooltip": true,

"forReport": true

}

]

}

(% style="color:#000000" %)Ответ:

1362

1363

(% style="color:#000000" %){

1364

1365

"vehicleId": "", ~/~/ID ТС

1366

"parentId": "", ~/~/Guid владельца ТС

1367

"name": "", ~/~/Имя объекта

1368

"imei": "", ~/~/IMEI

1369

"deviceTypeId": "", ~/~/ID типа устройства

1370

"modelId": "", ~/~/ID модели

1371

"unitId": "", ~/~/ID подразделения

1372

"sim1": "", ~/~/SIM1

1373

"sim2": "", ~/~/SIM2

1374

"consumptionPer100Km": "", ~/~/Расход топлива на 100 км

1375

"consumptionIdle": "", ~/~/Расход топлива на холостом ходу

1376

"counters": { ~/~/Счётчики

1377

"mileageEnabled": true,

1378

"motohoursEnabled": true,

"mileage": "",

"motohours": 345.0

},

"cmsv6Parameters": { ~/~/Параметры CmsV6

1383

"id": null,

1384

"enabled": true, ~/~/флаг включения

1385

"host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6

1386

"login": "", ~/~/ имя учетной записи

1387

"password": "" ~/~/ пароль учетной записи

1388

},

1389

"inspectionTasks": { ~/~/ задания на ТО

1390

"id": "", ~/~/ ID задачи

1391

"enabled": false, ~/~/ Признак включения

1392

"name": "", ~/~/ Имя задания

1393

"description": "", ~/~/ Описание задания

1394

"mileageCondition": "", ~/~/ Условие по пробегу

1395

"lastMileage": "", ~/~/ Пробег (в метрах)

1396

"motohoursCondition": "", ~/~/ Условие по моточасам

1397

"lastMotohours": "", ~/~/ Моточасы

1398

"periodicCondition": "", ~/~/ Условие периодичности по времени

1399

"kind": "", ~/~/ Вид периодичности по времени

1400

"maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)

1401

}

1402

1403

(% style="text-align:left" %)

1404

(% style="color:#000000" %)}

1405

1406

**Валидация:**

1407

- сезонный параметр может быть задан только если задана соответствующая обычная норма;

1408

- сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;

1409

- при задании сезонной нормы обязательны соответствующие даты начала/окончания.

1410

1411

== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) ==

1412

1413

(% class="box infomessage" %)

1414

(((

1415

(% lang="en-US" %)**POST /api/v3/vehicles/find**

1416

)))

1417

1418

(% style="color:#000000" %)Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).

1419

1420

(% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе:

1421

1422

(% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов;

1423

1424

(% style="color:#000000" %)− возвращает информацию об объектах с учетом заданных настроек видимости объектов;

1425

1426

(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав **«__Видимость объектов заблокированных договоров в панели управления__»** или **«__Видимость объектов заблокированных договоров в мониторинге__»**;

1427

1428

(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права **«__Просмотр номеров телефонов объектов__»**;

1429

1430

(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права **«__Просмотр статуса объекта__»**.

1431

1432

(% style="color:#000000" %)Метод запроса: **POST**

1433

1434

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/find>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/find]]

1435

1436

(% style="color:#000000" %)В заголовках запроса:

1437

1438

(% style="color:#000000" %)− Content-Type: __**application/json**__

1439

1440

(% style="color:#000000" %)− X-Auth: Токен авторизации

1441

1442

(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса.

1443

1444

(% style="color:#000000" %)Параметры в теле запроса (JSON):

1445

1446

{

1447

"vehicleId": null, ~/~/ 84350, ID ТС (int, опционально)

1448

"name": null, ~/~/ Имя ТС (string, опционально)

1449

"imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально)

1450

"sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально)

1451

"deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально)

1452

"parentId": null, ~/~/ ID клиента (Guid, опционально)

1453

"unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)

1454

"customFields": null ~/~/ значение любого из произвольных полей ТС

1455

}

1456

1457

(% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.

1458

1459

(% style="color:#000000" %)Ответ:

1460

1461

(% style="color:#000000" %){

1462

1463

(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта

1464

"name": "" ~/~/ наименование объекта

1465

"imei": "" ~/~/ IMEI объекта

1466

"deviceTypeId": "" ~/~/ идентификатор типа устройства

1467

"deviceTypeName": "" ~/~/ наименование типа устройства

1468

"sim1": "" ~/~/ первый номер телефона

1469

"sim2": "" ~/~/ второй номер телефона

1470

"parentId": "" ~/~/ идентификатор клиента-родителя

1471

"parentName": "" ~/~/ наименование клиента-родителя

1472

"modelId": "" ~/~/ идентификатор модели объекта

1473

"modelName": "" ~/~/ наименование модели объекта

1474

"unitId": "" ~/~/ идентификатор подразделения

1475

"unitName": "" ~/~/ наименование подразделения

1476

"status": "" ~/~/ статус объекта (%%)(-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика,

1477

~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан,

1478

~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)

1479

(% style="color:#000000" %) "createdAt": "" ~/~/ дата создания объектов

1480

"customFields": [

1481

{

1482

"id": "", ~/~/ идентификатор произвольного поля

1483

"name": "", ~/~/ имя произвольного поля

1484

"value": "", ~/~/ значение произвольного поля

1485

"forClient": true, ~/~/ право на отображение у клиента

1486

"forTooltip": false, ~/~/ право на отображение в подсказке

1487

"forReport": false ~/~/ право на отображение в отчетах

1488

}(%%)

1489

(% style="color:#000000" %)}

1490

1491

(% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.

1492

1493

== (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) ==

1494

1495

(% class="box successmessage" %)

1496

(((

1497

(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}**

1498

)))

1499

1500

(% style="color:#000000" %)Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе.

1501

1502

(% style="color:#000000" %)Метод запроса: **POST**

1503

1504

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/]](% style="color:#000000" %){vehicleId}

1505

1506

(% style="color:#000000" %)Параметр запроса: {__**vehicleId**__} - ID ТС

1507

1508

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1509

1510

(% style="color:#000000" %)Параметры в теле запроса (JSON):

1511

1512

(% style="color:#000000" %){

1513

1514

"status": "", ~/~/ значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика,

1515

~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан,

1516

~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)

1517

"date": "", ~/~/ Дата смены статуса (null если сменить немедленно)

1518

"description": "", ~/~/ Описание

1519

"data": "", ~/~/ Данные

1520

"overwrite": false, ~/~/ Флаг перезаписи

1521

"stage": "", ~/~/ Состояние, может быть null

1522

1523

(% style="color:#000000" %)}

1524

1525

(% style="color:#000000" %)Ответ:

1526

1527

(% style="color:#000000" %){

1528

1529

"status": "", ~/~/ значение статуса

1530

"date": "", ~/~/ Дата смены статуса

1531

"description": "", ~/~/ Описание

1532

"data": "", ~/~/ Данные

1533

"overwrite": false, ~/~/ Флаг перезаписи

1534

"stage": "", ~/~/ Состояние

1535

1536

(% style="text-align:left" %)

1537

(% style="color:#000000" %) }

1538

1539

== (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==

1540

1541

(% class="box warningmessage" %)

1542

(((

1543

(% lang="en-US" %)**PUT /api/v3/vehicles**

1544

)))

1545

1546

(% style="color:#000000" %)Метод позволяет отредактировать объект, указанный в запросе.

1547

1548

(% style="color:#000000" %)Метод запроса: **PUT**

1549

1550

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles>>url:https://hosting.glonasssoft.ru/api/v3/vehicles]]

1551

1552

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1553

1554

(% style="color:#000000" %)Параметры в теле запроса (JSON):

1555

1556

(% style="color:#000000" %){

1557

"vehicleId": , ~/~/ ID объекта

1558

"parentId": "" , ~/~/ ID клиента

1559

"name": "" , ~/~/ имя ТС

1560

"imei": "" , ~/~/ IMEI

1561

"deviceTypeId": "" , ~/~/ ID типа устройства

1562

"modelId": "" , ~/~/ ID модели

1563

"unitId": "" , ~/~/ ID подразделения

1564

"sim1": "" , ~/~/ Номер SIM 1

1565

"sim2": "" , ~/~/ Номер SIM2

1566

"consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено)

1567

"consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено)

1568

"consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу

1569

"consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км

1570

"consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас

1571

"consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу

1572

"consumptionPer100KmSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км

1573

"consumptionPer100KmSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км

1574

"consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас

1575

"consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас

1576

"consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х

1577

"consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х

1578

1579

"mileageCalcMethod": 0,

1580

"mileageCoeff": 0,

1581

"locationByCellId": true,

1582

"dottedLineTrackWhenNoCoords": true,

1583

"counters": ~/~/ счетчики

1584

{

1585

"mileage": "" , ~/~/ пробег

1586

"mileageEnabled": true, ~/~/ флаг активности счётчика "пробег"

1587

"motohours": "" , ~/~/ моточасы

1588

"motohoursEnabled": true ~/~/ флаг активности счётчика "моточасы"

1589

},

1590

"cmsv6Parameters": { ~/~/ параметры CMSv6

1591

"enabled": true, ~/~/ флаг включения

1592

"id": "" , ~/~/ идентификатор

1593

"host": "" , ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6

1594

"login": "" , ~/~/ имя учетной записи

1595

"password": "" ~/~/ пароль учетной записи

1596

},

1597

"inspectionTasks": ~/~/ задания на ТО

1598

{

1599

"enabled": "" , ~/~/ Признак включения

1600

"name": "" , ~/~/ Имя задания

1601

"description": "" , ~/~/ Описание задания

1602

"mileageCondition": "" , ~/~/ Условие по пробегу (в метрах, null - условие не работает)

1603

"lastMileage": "" , ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)

1604

"motohoursCondition": "" , ~/~/ Условие по моточасам (в секундах, null - условие не работает)

1605

"lastMotohours": "" , ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)

1606

"periodicCondition": "" , ~/~/ Условие периодичности по времени (null - условие не работает)

1607

"kind": "" , ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает)

1608

"lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано)

1609

"maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)

1610

}

1611

1612

"drivers": [ ~/~/ Водители

1613

{

1614

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"isDefault": true

}

],

"commandTemplates": [ ~/~/ Шаблон команды

1619

{

1620

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"name": "string",

"command": "string",

"retries": 0

}

],

"sensors": [ ~/~/ Датчики

1628

{

1629

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика

1630

"kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный

1631

"type": 0, ~/~/ Тип датчика

1632

"name": "string", ~/~/ Имя датчика

1633

"inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE

1634

"inputNumber": 0, ~/~/ Номер входа

1635

"pseudonym": "string", ~/~/ Псевдоним

1636

"medianDegree": 0, ~/~/ Медианная фильтрация

1637

"isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл.

1638

"disabled": true, ~/~/ Состояние: Отключен, true - Вкл., false - Выкл.

1639

"gradeType": 0, ~/~/ Тип тарировки, 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs

1640

"gradesTables": [ ~/~/ Массив таблиц тарировки

1641

{

1642

"grades": [ ~/~/ Таблица тарировки 1

1643

{

1644

"input": 0, ~/~/ Входящее значение

1645

"output": 0 ~/~/ Выходящее значение

1646

}

1647

],

1648

"relevanceTime": "2023-05-22T09:57:39.562Z" ~/~/ Дата/время начала применения тарировочной таблицы

1649

}

1650

],

1651

"showInTooltip": true, ~/~/ Отображать в подсказке

1652

"showLastValid": true, ~/~/ Отображать последнее валидное значение

1653

"showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива

1654

"showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания

1655

"agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION

1656

"expr": "string", ~/~/ Формула

1657

"children": [ ~/~/ массив дочерних датчиков

1658

"string"

1659

],

1660

"customParams": { ~/~/ прочие произвольные параметры

1661

"additionalProp1": "string",

1662

"additionalProp2": "string",

1663

"additionalProp3": "string"

1664

},

1665

1666

~/~/ Характерные для произвольного:

1667

1668

~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off

1669

1670

~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы

1671

1672

~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off

1673

1674

~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний

1675

1676

~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off

1677

1678

~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off

1679

1680

~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off

1681

1682

~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)

1683

1684

~/~/ Характерные для таблицы тарировки Вкл./Выкл.:

1685

1686

~/~/ "ValueOn": "Вкл.",

1687

1688

~/~/ "ValueOff": "Выкл."

1689

"summaryMaxValue": 0 ~/~/ Макс. значение

1690

}

1691

],

1692

"customFields": [ ~/~/ Произвольные поля

1693

{

1694

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"name": "string",

"value": "string",

"forClient": true,

"forTooltip": true,

"forReport": true

}

]

}

(% style="color:#000000" %)Ответ:

1705

1706

(% lang="en-US" style="text-align:left" %)

1707

(% lang="ru-RU" style="color:#000000; font-weight:normal" %){

1708

1709

(% lang="en-US" style="text-align:left" %)

1710

"vehicleId": "", ~/~/ ID ТС

1711

"parentId": "", ~/~/ ID клиента

1712

"name": "", ~/~/ имя ТС

1713

"imei": "", ~/~/ IMEI

1714

"deviceTypeId": "", ~/~/ типа устройства

1715

"modelId": "", ~/~/ ID модели

1716

"unitId": "", ~/~/ ID подразделения

1717

"sim1": "", ~/~/ SIM 1

1718

"sim2": "", ~/~/ SIM2

1719

"consumptionPer100Km": "", ~/~/ Расход топлива на 100 км

1720

"consumptionIdle": "", ~/~/ Расход топлива на холостом ходу

1721

"counters":

1722

{

1723

"mileageEnabled": true, ~/~/ флаг активности счётчика «пробег»

1724

"motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы»

1725

"mileage": "", ~/~/ пробег

1726

"motohours": "", ~/~/ моточасы

1727

}

1728

"cmsv6Parameters": ~/~/ параметры CMSv6

1729

{

1730

"id": ~/~/ идентификатор

1731

"enabled": true, ~/~/ флаг включения

1732

"host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6

1733

"login": "", ~/~/ имя учетной записи

1734

"password": "", ~/~/ пароль учетной записи

1735

}

1736

"inspectionTasks": ~/~/ задания на ТО

1737

{

1738

"id": "", ~/~/ ID задания

1739

"enabled": false, ~/~/ Признак включения

1740

"name": "", ~/~/ Имя задания

1741

"description": "", ~/~/ Описание задания

1742

"mileageCondition": "", ~/~/ Условие по пробегу

1743

"lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО

1744

"motohoursCondition": "", ~/~/ Условие по моточасам

1745

"lastMotohours": "", ~/~/ Моточасы

1746

"periodicCondition": "", ~/~/ Условие периодичности по времени

1747

"kind": "", ~/~/ Вид периодичности по времени

1748

"maxQuantity": "", ~/~/ Сколько раз выполнить задание

1749

}

1750

1751

(% lang="en-US" style="text-align:left" %)

1752

(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}

1753

1754

**Валидация:**

1755

- сезонный параметр может быть задан только если задана соответствующая обычная норма;

1756

- сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;

1757

- при задании сезонной нормы обязательны соответствующие даты начала/окончания.

1758

1759

== (% style="color:#000000; font-size:16px" %)**Удаление объекта**(%%) ==

1760

1761

(% class="box errormessage" %)

1762

(((

1763

(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**

1764

)))

1765

1766

(% style="color:#000000" %)Метод позволяет удалить объект, указанный в строке запроса.

1767

1768

(% style="color:#000000" %)Метод запроса: **DELETE**

1769

1770

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){vehicleId}

1771

1772

(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid объекта

1773

1774

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1775

1776

(% style="text-align:left" %)

1777

(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**

1778

1779

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Устройства**(%%) =

1780

1781

== (% style="color:#000000; font-size:16px" %)**Получение списка типов устройств**(%%) ==

1782

1783

(% class="box infomessage" %)

1784

(((

1785

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/devices/types**

1786

)))

1787

1788

(% style="color:#000000" %)Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе.

1789

1790

(% style="color:#000000" %)Метод запроса: **GET**

1791

1792

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]]

1793

1794

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1795

1796

(% style="color:#000000" %)Ответ:

1797

1798

(% style="color:#000000" %){

1799

1800

"deviceTypeId" : "", ~/~/ ID типа устройства

1801

"deviceTypeName" : "" ~/~/ Название типа устройства

1802

1803

(% style="text-align:left" %)

1804

(% style="color:#000000" %)}

1805

1806

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) =

1807

1808

== (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) ==

1809

1810

(% class="box infomessage" %)

1811

(((

1812

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types**

1813

)))

1814

1815

(% style="color:#000000" %)Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе.

1816

1817

(% style="color:#000000" %)Метод запроса: **GET**

1818

1819

(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/sensors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]]

1820

1821

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1822

1823

(% style="color:#000000" %)Ответ:

1824

1825

(% style="color:#000000" %){

1826

1827

"id": "", ~/~/ ID типа датчика

1828

"name": "", ~/~/ Название

1829

"description": "", ~/~/ Описание

1830

1831

(% style="text-align:left" %)

1832

(% style="color:#000000" %)}

1833

1834

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) =

1835

1836

== (% style="color:#000000; font-size:16px" %)**Данные об активности объекта**(%%) ==

1837

1838

(% class="box infomessage" style="text-align: left;" %)

1839

(((

1840

**POST /api/v3/terminalMessages/count**

1841

)))

1842

1843

(% style="text-align: left;" %)

1844

Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период.

1845

1846

(% style="text-align: left;" %)

1847

Метод запроса **POST**

1848

1849

(% style="text-align: left;" %)

1850

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/count

1851

1852

(% style="text-align: left;" %)

1853

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1854

1855

(% style="text-align: left;" %)

1856

{

1857

"vehicleIds": [

1858

id ~/~/ здесь передается список идентификаторов объектов

1859

],

1860

"from": "2023-03-12T07:09:02.364Z", ~/~/ от какой даты выполнять запрос

1861

"to": "2023-03-14T07:09:02.364Z" ~/~/ до какой даты выполнять запрос

1862

}

1863

1864

(% style="text-align: left;" %)

1865

Ответ:

1866

1867

(% style="text-align: left;" %)

1868

[

1869

{

1870

"vehicleId": 0, ~/~/ идентификатор объекта

1871

"count": 0 ~/~/ количество сообщений за период

}

]

== (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) ==

1876

1877

(% class="box infomessage" %)

1878

(((

1879

**POST /api/v3/terminalMessages**

1880

)))

1881

1882

Метод возвращает список сообщений терминала объекта за выбранный период.

1883

1884

(% style="text-align: left;" %)

1885

Метод запроса **POST**

1886

1887

(% style="text-align: left;" %)

1888

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages

1889

1890

(% style="text-align: left;" %)

1891

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1892

1893

{

1894

"vehicleId": 0, ~/~/ id объекта

1895

"from": "2023-03-29T09:14:46.107Z", ~/~/ начало периода запроса

1896

"to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса

}

Ответ:

[

{

"messages": [

{

"deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства

1906

"serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера

1907

"speed": 0, ~/~/ Скорость, км/ч

1908

"altitude": 0, ~/~/ Высота, м

1909

"latitude": 0, ~/~/ Широта [-90°;90°]

1910

"longitude": 0, ~/~/ Долгота [-180°;180°]

1911

"satellites": 0, ~/~/ Кол-во спутников

1912

"voltage": 0, ~/~/ Напряжение

1913

"parameters": { ~/~/ список параметров датчиков передаваемых терминалом

1914

"additionalProp1": "string",

1915

"additionalProp2": "string",

1916

"additionalProp3": "string"

1917

},

1918

"photoCount": 0 ~/~/ Кол-во фото

}

]

}

]

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) =

1925

1926

== (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) ==

1927

1928

(% class="box infomessage" %)

1929

(((

1930

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/mileageAndMotohours**

1931

)))

1932

1933

(% style="color:#000000" %)Метод запроса: **POST**

1934

1935

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/mileageAndMotohours

1936

1937

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1938

1939

(% style="text-align:left" %)

Тело запроса:

{

"sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.

1944

"vehicleIds": [0], ~/~/ Список ID объектов

1945

"from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода

1946

"to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода

1947

"timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3

}

Ответ:

[

{

"vehicleId": 0, ~/~/ ID объекта

1955

"name": "string", ~/~/ Имя ТС

1956

"periods": [ ~/~/ Периоды

1957

{

1958

"start": "2023-08-09T14:23:14.574Z", ~/~/ Начало

1959

"end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание

1960

"mileageBegin": 0, ~/~/ Пробег на начало периода

1961

"mileageEnd": 0, ~/~/ Пробег на окончание периода

1962

"motohoursBegin": 0, ~/~/ Моточасы на начало периода

1963

"motohoursEnd": 0 ~/~/ Моточасы на окончание периода

}

]

}

]

== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) ==

1970

1971

(% class="box infomessage" %)

1972

(((

1973

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelConsumption**

1974

)))

1975

1976

(% style="color:#000000" %)Метод запроса: **POST**

1977

1978

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelConsumption

1979

1980

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

1981

1982

(% style="text-align:left" %)

Тело запроса:

{

"sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.

1987

"vehicleIds": [0], ~/~/ Список ID объектов

1988

"from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода

1989

"to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода

1990

"timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3

}

Ответ:

[

{

"vehicleId": 0, ~/~/ ID объекта

1998

"name": "string", ~/~/ Имя ТС

1999

"periods": [ ~/~/ Периоды

2000

{

2001

"start": "2023-08-09T14:23:14.574Z", ~/~/ Начало

2002

"end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание

2003

"fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода

2004

"fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода

2005

"fuelConsumption": 0, ~/~/ Расход топлива

2006

"fuelConsumptionMove": 0 ~/~/ Расход топлива в движении

}

]

}

]

== (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) ==

2013

2014

(% class="box infomessage" %)

2015

(((

2016

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelInOut**

2017

)))

2018

2019

(% style="color:#000000" %)Метод запроса: **POST**

2020

2021

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelInOut

2022

2023

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2024

2025

(% style="text-align:left" %)

Тело запроса:

{

"vehicleIds": [0], ~/~/ Список ID объектов

2030

"from": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время начало запроса

2031

"to": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время окончания запроса

2032

"timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3

}

Ответ:

[

{

"start": "2023-08-09T14:27:44.773Z", ~/~/ Начало периода

2040

"end": "2023-08-09T14:27:44.773Z", ~/~/ Окончание периода

2041

"vehicleId": 0, ~/~/ ID объекта

2042

"name": "string", ~/~/ Имя объекта

2043

"model": "string", ~/~/ Модель объекта

2044

"fuels": [ ~/~/ Массив данным по заправкам и сливам

2045

{

2046

"event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив

2047

"startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало

2048

"endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание

2049

"valueFuel": 0, ~/~/ Количество

2050

"fuelStart": 0, ~/~/ Уровень топлива на начало события

2051

"fuelEnd": 0 ~/~/ Уровень топливо на конец события

}

]

}

]

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =

2058

2059

== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==

2060

2061

(% class="box infomessage" %)

2062

(((

2063

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find**

2064

)))

2065

2066

(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них.

2067

2068

(% style="color:#000000" %)Метод запроса: **POST**

2069

2070

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find

2071

2072

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2073

2074

(% style="text-align:left" %)

2075

Тело запроса:

2076

2077

(% style="text-align:left" %)

2078

{

2079

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

2080

}

2081

2082

(% style="text-align:left" %)

Ответ:

[

{

"id": 0, ~/~/ Идентификатор объекта геозоны

2088

"name": "string", ~/~/ Название объекта геозоны

2089

"type": 0, ~/~/ Тип объекта геозоны

2090

"fname": "string", ~/~/ Имя файла

2091

"parentId": "string", ~/~/ Идентификатор клиента

2092

"radius": 0, ~/~/ Радиус геообъекта

2093

"beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета

2094

"endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета

2095

"description": "string", ~/~/ Описание

2096

"area": 0, ~/~/ Площадь, м^^2^^

2097

"perimetr": 0, ~/~/ Периметр, м

2098

"createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания

}

]

== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) ==

2103

2104

(% class="box infomessage" %)

2105

(((

2106

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles**

2107

)))

2108

2109

(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период.

2110

2111

(% style="color:#000000" %)Метод запроса: **POST**

2112

2113

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles

2114

2115

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2116

2117

(% style="text-align:left" %)

Тело запроса:

{

"startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса

2122

"endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания

2123

"ids": [ ], ~/~/ Массив id объектов

2124

"byTime": 0, ~/~/ Объединение событий по времени

2125

"byDist": 0, ~/~/ Объединение событий по расстоянию

2126

"filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения

2127

"filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра

}

Ответ:

[

{

"geozoneId": 0, ~/~/ ID геообъекта

2134

"geozoneName": "string", ~/~/ Название геообъекта

2135

"startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда

2136

"endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда

2137

"duration": 0, ~/~/ Продолжительность нахождения в геообъекте

2138

"vehicleId": 0, ~/~/ ID объекта

2139

"vehicleName": "string" ~/~/ Имя объекта

}

]

== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) ==

2144

2145

(% class="box infomessage" %)

2146

(((

2147

(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones**

2148

)))

2149

2150

(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период.

2151

2152

(% style="color:#000000" %)Метод запроса: **POST**

2153

2154

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones

2155

2156

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2157

2158

(% style="text-align:left" %)

Тело запроса:

{

"startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса

2163

"endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания

2164

"ids": [ ], ~/~/ Массив id геообъектов

2165

"byTime": 0, ~/~/ Объединение событий по времени

2166

"byDist": 0, ~/~/ Объединение событий по расстоянию

2167

"filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения

2168

"filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра

}

Ответ:

[

{

"geozoneId": 0, ~/~/ ID геообъекта

2176

"geozoneName": "string", ~/~/ Название геообъекта

2177

"startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда

2178

"endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда

2179

"duration": 0, ~/~/ Продолжительность нахождения в геообъекте

2180

"vehicleId": 0, ~/~/ ID объекта

2181

"vehicleName": "string" ~/~/ Имя объекта

}

]

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =

2186

2187

== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==

2188

2189

(% class="box infomessage" %)

2190

(((

2191

**POST /api/v3/notifications/find**

2192

)))

2193

2194

Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии.

2195

2196

(% style="text-align: left;" %)

2197

Метод запроса **POST**

2198

2199

(% style="text-align: left;" %)

2200

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find

2201

2202

(% style="text-align: left;" %)

2203

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2204

2205

{

2206

"parentId": "" ~/~/ id клиента

}

Ответ:

[

{

"id": 0, ~/~/ ID уведомления

2214

"name": "string", ~/~/ Название уведомления

2215

"active": true, ~/~/ Состояние true - активен, false - деактивирован

2216

"type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО

2217

"userId": "", ~/~/ Пользователь, создавший уведомление

2218

"parentId": "", ~/~/ Идентификатор клиента

2219

"parentName": "string" ~/~/ Имя клиента

}

]

== (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) ==

2224

2225

(% class="box infomessage" %)

2226

(((

2227

**GET /api/v3/notifications/{id}**

2228

)))

2229

2230

Метод возвращает данные правил формирования выбранного уведомления.

2231

2232

(% style="text-align: left;" %)

2233

Метод запроса **GET**

2234

2235

(% style="text-align: left;" %)

2236

(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/{id}

2237

2238

(% style="text-align: left;" %)

2239

(% style="color:#000000" %)Параметр запроса: {**__id__**} - (%%)id уведомления

2240

2241

(% style="text-align: left;" %)

2242

(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации

2243

2244

(% style="text-align: left;" %)

2245

(% style="color:#000000" %)Ответ:

2246

2247

(% style="text-align: left;" %)

2248

(% style="color:#000000" %){

2249

"id": 0, ~/~/ (%%)id уведомления

2250

(% style="color:#000000" %) "type": 0, (%%)~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО

2251

(% style="color:#000000" %) "userId": "", /(%%)/ Пользователь, создавший уведомление

2252

(% style="color:#000000" %) "parentId": "", (%%)~/~/ Идентификатор клиента

2253

(% style="color:#000000" %) "parentName": "string", (%%)~/~/ Имя клиента

2254

(% style="color:#000000" %) "name": "string", (%%)~/~/ Название уведомления

2255

(% style="color:#000000" %) "active": true, (%%)~/~/ Состояние true - активен, false - деактивирован

2256

(% style="color:#000000" %) "vehicleIds": [ ~/~/ (%%)Список id объектов для анализа

2257

(% style="color:#000000" %) 0

2258

],

2259

"geoids": [ ~/~/ (%%)Список id геообъектов для анализа

2260

(% style="color:#000000" %) 0

2261

],

2262

"fieldids": [ ~/~/ (%%)Список id полей для анализа

2263

(% style="color:#000000" %) 0

2264

],

2265

"settings": { ~/~/ Список параметров уведомления

2266

"additionalProp1": "string",

2267

"additionalProp2": "string",

2268

"additionalProp3": "string"

2269

},

2270

"toEmail": true, ~/~/ (%%)Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"

2271

(% style="color:#000000" %) "recipientIds": [ ~/~/ (%%)Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила

2272

(% style="color:#000000" %) ""

2273

],

2274

"enableSideEmails": true, ~/~/ (%%)Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"

2275

(% style="color:#000000" %) "sideEmails": [ ~/~/ (%%)Список электронных адресов для отсылки уведомлений

2276

(% style="color:#000000" %) "string"

2277

],

2278

"toTelegram": true, ~/~/ (%%)Флаг активности отправки в Telegram

2279

(% style="color:#000000" %) "telegrams": [ ~/~/ (%%)Список получателя уведомлений в Telegram.

2280

(% style="color:#000000" %) {

2281

"id": 0, ~/~/ (%%)Идентификатор участника чата

2282

(% style="color:#000000" %) "info": "string" ~/~/ (%%)Дополнительные сведения

2283

(% style="color:#000000" %) }

2284

],

2285

"toMobile": true, ~/~/ (%%)Флаг активности отправки в мобильное приложение

2286

(% style="color:#000000" %) "toClient": true, ~/~/ (%%)Флаг активности отправки в интерфейсе системы

2287

(% style="color:#000000" %) "stored": true, ~/~/ (%%)Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.

2288

(% style="color:#000000" %) "kind": 0, ~/~/ (%%)Определяет вид уведомления

2289

(% style="color:#000000" %) "activationMode": 0, ~/~/ (%%)Вид активации уведомления 0 - Сейчас, 1 - В определенную дату и время

2290

(% style="color:#000000" %) "activationTime": "2023-03-29T09:57:48.932Z", ~/~/ (%%)Дата/время активации правила (UTC)

2291

(% style="color:#000000" %) "timezone": 0, ~/~/ (%%)Сдвиг часового пояса

2292

(% style="color:#000000" %) "validity": 0, ~/~/ (%%)Срок действия в днях (1-90)

2293

(% style="color:#000000" %) "autoProlongation": true ~/~/ (%%)Автопродление срока действия

2294

(% style="color:#000000" %)}

2295

2296

== (% style="color:#000000; font-size:16px" %)**Редактирование уведомления**(%%) ==

2297

2298

(% class="box warningmessage" %)

2299

(((

2300

**PUT /api/v3/notifications/**

2301

)))

2302

2303

Метод позволяет отредактировать уведомление.

2304

2305

Метод запроса **PUT**

2306

2307

URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications

2308

2309

В заголовках запроса: X-Auth: Токен авторизации

Тело запроса:

{

"id": 0, ~/~/ id уведомления

2314

"type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО

2315

"userId": "", ~/~/ Пользователь, создавший уведомление

2316

"parentId": "", ~/~/ Идентификатор клиента

2317

"parentName": "string", ~/~/ Имя клиента

2318

"name": "string", ~/~/ Название уведомления

2319

"active": true, ~/~/ Состояние true - активен, false - деактивирован

2320

"vehicleIds": [ ~/~/ Список id объектов для анализа

2321

0

2322

],

2323

"geoids": [ ~/~/ Список id геообъектов для анализа

2324

0

2325

],

2326

"fieldids": [ ~/~/ Список id полей для анализа

2327

0

2328

],

2329

"settings": { ~/~/ Список параметров уведомления

2330

"additionalProp1": "string",

2331

"additionalProp2": "string",

2332

"additionalProp3": "string"

2333

},

2334

"toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"

2335

"recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила

2336

""

2337

],

2338

"enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"

2339

"sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений

2340

"string"

2341

],

2342

"toTelegram": true, ~/~/ Флаг активности отправки в Telegram

2343

"telegrams": [ ~/~/ Список получателя уведомлений в Telegram.

2344

{

2345

"id": 0, ~/~/ Идентификатор участника чата

2346

"info": "string" ~/~/ Дополнительные сведения

2347

}

2348

],

2349

"toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение

2350

"toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы

2351

"stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.

2352

"kind": 0, ~/~/ Определяет вид уведомления

2353

"activationMode": 0, ~/~/ Вид активации уведомления 0 - Сейчас, 1 - В определенную дату и время

2354

"activationTime": "2023-03-29T09:57:48.932Z", ~/~/ Дата и время активации правила (UTC)

2355

"timezone": 0, ~/~/ Сдвиг часового пояса

2356

"validity": 0, ~/~/ Срок действия в днях (1-90)

2357

"autoProlongation": true ~/~/ Автопродление срока действия

}

Ответ:

Success

== (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) ==

2365

2366

(% class="box errormessage" %)

2367

(((

2368

**DELETE /api/v3/notifications/{id}**

2369

)))

2370

2371

Метод позволяет удалить выбранное уведомление.

2372

2373

Метод запроса **DELETE**

2374

2375

URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/{id}

2376

2377

Передаваемый параметр: {id} - id уведомления

2378

2379

В заголовках запроса: X-Auth: Токен авторизации

Ответ:

Success

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Водители**(%%) =

2387

2388

== (% style="color:#000000; font-size:16px" %)**Получить список водителей клиента**(%%) ==

2389

2390

(% class="box infomessage" %)

2391

(((

2392

**POST /api/v3/Drivers/find**

2393

)))

2394

2395

Передается параметр: parentId - ID клиента-родителя

Ответ:

[

{

"name": "string", ~/~/ Определяет наименование

2402

"description": "string", ~/~/ Определяет описание

2403

"hiredate": "2023-06-30T09:37:58.407Z", ~/~/ Определяет дату найма

2404

"chopdate": "2023-06-30T09:37:58.407Z", ~/~/ Определяет дату увольнения

2405

"exclusive": true, ~/~/ Определяет признак "Исключительный"

2406

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID водителя

2407

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя

2408

"deleted": true ~/~/ Признак удаления

}

]

== (% style="color:#000000; font-size:16px" %)**Получить данные о водителе**(%%) ==

2413

2414

(% class="box infomessage" %)

2415

(((

2416

**GET /api/v3/Drivers/{driverGuid}**

2417

)))

2418

2419

Передается параметр: ID водителя

Ответ:

{

"name": "string", ~/~/ Определяет наименование

2425

"description": "string", ~/~/ Определяет описание

2426

"hiredate": "2023-06-30T09:33:33.083Z", ~/~/ Определяет дату найма

2427

"chopdate": "2023-06-30T09:33:33.083Z", ~/~/ Определяет дату увольнения

2428

"exclusive": true, ~/~/ Определяет признак "Исключительный"

2429

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID водителя

2430

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя

2431

"deleted": true ~/~/ Признак удаления

2432

}

2433

2434

== (% style="color:#000000; font-size:16px" %)**Добавить водителя**(%%) ==

2435

2436

(% class="box successmessage" %)

2437

(((

2438

**POST /api/v3/Drivers**

)))

Запрос:

{

"name": "string",

"description": "string",

2446

"hiredate": "2023-06-30T12:50:54.020Z",

2447

"chopdate": "2023-06-30T12:50:54.020Z",

2448

"exclusive": true,

2449

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2450

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true

}

Ответ:

{

"name": "string",

"description": "string",

2459

"hiredate": "2023-06-30T12:50:54.051Z",

2460

"chopdate": "2023-06-30T12:50:54.051Z",

2461

"exclusive": true,

2462

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2463

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true

}

== (% style="color:#000000; font-size:16px" %)**Редактировать водителя**(%%) ==

2469

2470

(% class="box warningmessage" %)

2471

(((

2472

**PUT /api/v3/Drivers**

)))

Запрос:

{

"name": "string",

"description": "string",

2480

"hiredate": "2023-06-30T12:50:27.910Z",

2481

"chopdate": "2023-06-30T12:50:27.910Z",

2482

"exclusive": true,

2483

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2484

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true

}

Ответ:

{

"name": "string",

"description": "string",

2493

"hiredate": "2023-06-30T12:50:27.929Z",

2494

"chopdate": "2023-06-30T12:50:27.929Z",

2495

"exclusive": true,

2496

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2497

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"deleted": true

}

== (% style="color:#000000; font-size:16px" %)**Удалить водителя**(%%) ==

2503

2504

(% class="box errormessage" %)

2505

(((

2506

**DELETE /api/v3/Drivers/{driverGuid}**

2507

)))

2508

2509

Передается параметр: ID водителя

Ответ:

Success

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Журнал назначений**(%%) =

2517

2518

== (% style="color:#000000; font-size:18.6667px" %)**Назначение водителя на объект**(%%) ==

2519

2520

=== (% style="color:#000000; font-size:16px" %)**Получить назначения водителей запросом к водителю**(%%) ===

2521

2522

(% class="box infomessage" %)

2523

(((

2524

**POST /api/v3/DriversVehiclesAssignments/GetByDrivers**

)))

Запрос:

{

"Ids": [

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

2532

],

2533

"BeginTime": "2023-06-30T12:49:04.365Z",

2534

"EndTime": "2023-06-30T12:49:04.365Z"

}

Ответ:

[

{

"VehicleId": 0,

"CreateTime": "2023-06-30T09:52:31.240Z",

2543

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2544

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2545

"BeginTime": "2023-06-30T09:52:31.240Z",

2546

"EndTime": "2023-06-30T09:52:31.240Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Получить назначения водителей запросом к объекту**(%%) ===

2552

2553

(% class="box infomessage" %)

2554

(((

2555

**POST /api/v3/DriversVehiclesAssignments/GetByVehicles**

)))

Запрос:

{

"Ids": [

0

],

"BeginTime": "2023-06-30T12:48:39.419Z",

2565

"EndTime": "2023-06-30T12:48:39.419Z"

}

Ответ:

[

{

"VehicleId": 0,

"CreateTime": "2023-06-30T09:54:01.631Z",

2574

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2575

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2576

"BeginTime": "2023-06-30T09:54:01.631Z",

2577

"EndTime": "2023-06-30T09:54:01.631Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Создать назначение водителя на объект**(%%) ===

2583

2584

(% class="box successmessage" %)

2585

(((

2586

**POST /api/v3/DriversVehiclesAssignments**

2587

)))

2588

2589

Передается массив назначений

Запрос:

[

{

"VehicleId": 0, ~/~/ Идентификатор объекта

2596

"CreateTime": "2023-06-30T11:04:46.902Z", ~/~/ Момент времени создания назначения

2597

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя

2598

"BeginTime": "2023-06-30T11:04:46.902Z", ~/~/ Момент времени начала назначения

2599

"EndTime": "2023-06-30T11:04:46.902Z" ~/~/ Момент времени окончания назначения. Необязательно.

}

]

Ответ:

[

{

"VehicleId": 0,

"CreateTime": "2023-06-30T11:04:46.903Z",

2609

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2610

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2611

"BeginTime": "2023-06-30T11:04:46.903Z",

2612

"EndTime": "2023-06-30T11:04:46.903Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Изменить назначения водителей на объекты**(%%) ===

2618

2619

(% class="box warningmessage" %)

2620

(((

2621

**PUT /api/v3/DriversVehiclesAssignments**

)))

Запрос:

[

{

"VehicleId": 0,

"CreateTime": "2023-06-30T11:14:08.117Z",

2630

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения

2631

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2632

"BeginTime": "2023-06-30T11:14:08.117Z",

2633

"EndTime": "2023-06-30T11:14:08.117Z"

}

]

Ответ:

[

{

"VehicleId": 0,

"CreateTime": "2023-06-30T11:14:53.349Z",

2643

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2644

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2645

"BeginTime": "2023-06-30T11:14:53.349Z",

2646

"EndTime": "2023-06-30T11:14:53.349Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Удалить назначения водителей на объекты**(%%) ===

2652

2653

(% class="box errormessage" %)

2654

(((

2655

**DELETE /api/v3/DriversVehiclesAssignments**

)))

Запрос:

[

"3fa85f64-5717-4562-b3fc-2c963f66afa6",

]

Ответ:

Success

== (% style="color:#000000; font-size:18.6667px" %)**Назначение карты-метки водителю**(%%) ==

2670

2671

=== (% style="color:#000000; font-size:16px" %)**Получить назначения меток запросом к водителю**(%%) ===

2672

2673

(% class="box infomessage" %)

2674

(((

2675

**POST /api/v3/DriversRfidsAssignments/GetByDrivers**

)))

Запрос:

{

"Ids": [

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

2683

],

2684

"BeginTime": "2023-06-30T12:47:12.162Z",

2685

"EndTime": "2023-06-30T12:47:12.162Z"

}

Ответ:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор метки

2693

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения

2694

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя

2695

"BeginTime": "2023-06-30T11:19:40.703Z",

2696

"EndTime": "2023-06-30T11:19:40.703Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Получить назначения меток запросом к карте-метке**(%%) ===

2702

2703

(% class="box infomessage" %)

2704

(((

2705

**POST /api/v3/DriversRfidsAssignments/GetByRfids**

)))

Запрос:

{

"Ids": [

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

2713

],

2714

"BeginTime": "2023-06-30T12:47:12.162Z",

2715

"EndTime": "2023-06-30T12:47:12.162Z"

}

Ответ:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор метки

2723

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения

2724

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя

2725

"BeginTime": "2023-06-30T11:19:40.703Z",

2726

"EndTime": "2023-06-30T11:19:40.703Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Добавить назначения меток на водителей**(%%) ===

2732

2733

(% class="box successmessage" %)

2734

(((

2735

**POST /api/v3/DriversRfidsAssignments**

)))

Запрос:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2743

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2744

"BeginTime": "2023-06-30T11:27:08.635Z",

2745

"EndTime": "2023-06-30T11:27:08.635Z"

}

]

Ответ:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2754

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2755

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2756

"BeginTime": "2023-06-30T11:27:08.677Z",

2757

"EndTime": "2023-06-30T11:27:08.677Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Изменить назначения меток на водителей**(%%) ===

2763

2764

(% class="box warningmessage" %)

2765

(((

2766

**PUT /api/v3/DriversRfidsAssignments**

)))

Запрос:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2774

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2775

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2776

"BeginTime": "2023-06-30T11:28:43.330Z",

2777

"EndTime": "2023-06-30T11:28:43.330Z"

}

]

Ответ:

[

{

"Rfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2786

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2787

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2788

"BeginTime": "2023-06-30T11:28:43.331Z",

2789

"EndTime": "2023-06-30T11:28:43.331Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Удалить назначения меток на водителей**(%%) ===

2795

2796

(% class="box errormessage" %)

2797

(((

2798

**DELETE /api/v3/DriversRfidsAssignments**

)))

Запрос:

[

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

]

Ответ:

Success

== (% style="color:#000000; font-size:18.6667px" %)**Назначение топливной карты водителю**(%%) ==

2813

2814

=== (% style="color:#000000; font-size:16px" %)**Получить назначения топливных карт запросом к водителю**(%%) ===

2815

2816

(% class="box infomessage" %)

2817

(((

2818

**POST /api/v3/DriversFuelCardsAssignments/GetByDrivers**

)))

Запрос:

{

"Ids": [

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

2826

],

2827

"BeginTime": "2023-06-30T12:45:10.852Z",

2828

"EndTime": "2023-06-30T12:45:10.852Z"

}

Ответ:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2836

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2837

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2838

"BeginTime": "2023-06-30T11:58:04.695Z",

2839

"EndTime": "2023-06-30T11:58:04.695Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Получить назначения топливных карт запросом к топливной карте**(%%) ===

2845

2846

(% class="box infomessage" %)

2847

(((

2848

**POST /api/v3/DriversFuelCardsAssignments/GetByCards**

)))

Запрос:

{

"Ids": [

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

2856

],

2857

"BeginTime": "2023-06-30T12:45:10.852Z",

2858

"EndTime": "2023-06-30T12:45:10.852Z"

}

Ответ:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2866

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2867

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2868

"BeginTime": "2023-06-30T11:58:04.695Z",

2869

"EndTime": "2023-06-30T11:58:04.695Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Добавить назначение топливной карты водителю**(%%) ===

2875

2876

(% class="box successmessage" %)

2877

(((

2878

**POST /api/v3/DriversFuelCardsAssignments**

)))

Запрос:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2886

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2887

"BeginTime": "2023-06-30T12:09:53.175Z",

2888

"EndTime": "2023-06-30T12:09:53.175Z"

}

]

Ответ:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2897

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2898

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2899

"BeginTime": "2023-06-30T12:09:53.201Z",

2900

"EndTime": "2023-06-30T12:09:53.201Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Редактировать назначение топливной карты водителю**(%%) ===

2906

2907

(% class="box warningmessage" %)

2908

(((

2909

**PUT /api/v3/DriversFuelCardsAssignments**

)))

Запрос:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2917

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2918

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2919

"BeginTime": "2023-06-30T12:09:53.201Z",

2920

"EndTime": "2023-06-30T12:09:53.201Z"

}

]

Ответ:

[

{

"CardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2929

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2930

"DriverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2931

"BeginTime": "2023-06-30T12:09:53.201Z",

2932

"EndTime": "2023-06-30T12:09:53.201Z"

}

]

=== (% style="color:#000000; font-size:16px" %)**Удалить назначение топливной карты водителю**(%%) ===

2938

2939

(% class="box errormessage" %)

2940

(((

2941

**DELETE /api/v3/DriversFuelCardsAssignments**

)))

Запрос:

[

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

]

Ответ:

Success

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Назначения агрегатов**(%%) =

2956

2957

== (% style="color:#000000; font-size:16px" %)**Получить список назначений агрегатов на выбранные объекты**(%%) ==

2958

2959

(% class="box infomessage" %)

2960

(((

2961

**POST /api/v3/Trailers**

)))

Пример запроса:

{

"startDate": "2023-11-14T10:48:03.671Z",

2968

"endDate": "2023-11-14T10:48:03.671Z",

"ids": [ 0 ],

"timezone": 0

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

2974

|(% style="width:215px" %)startDate|(% style="width:861px" %)Дата и время начала запроса

2975

|(% style="width:215px" %)endDate|(% style="width:861px" %)Дата и время окончания запроса

2976

|(% style="width:215px" %)ids|(% style="width:861px" %)Массив ID объектов

2977

|(% style="width:215px" %)timezone|(% style="width:861px" %)Часовой пояс, по умолчанию UTC.

Пример ответа:

[

{

"SD": "2023-11-14T10:48:03.717Z",

2984

"ED": "2023-11-14T10:48:03.717Z",

"id": 0,

"SLat": 0,

"SLon": 0,

"ELat": 0,

"ELon": 0,

"mileage": 0

"Duration": 0

"Address": "string",

"Address2": "string",

2994

"name": "string",

2995

"rid": "string",

2996

"rguid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2997

"trailer": {

2998

"ModelGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

2999

"Number": "string",

3000

"Description": "string",

3001

"OwnerGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3002

"ExternalID": "string",

3003

"Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3004

"CreateTime": "2023-11-14T10:48:03.717Z",

3005

"UpdateTime": "2023-11-14T10:48:03.717Z",

"IsDeleted": true

},

"filesCount": 0,

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3013

|SD|Дата и время начала события

3014

|ED|Дата и время окончания события

3015

|id|ID объекта

3016

|SLat|Широта начальной координаты

3017

|SLon|Долгота начальной координаты

3018

|ELat|Широта конечной координаты

3019

|ELon|Долгота конечной координаты

3020

|mileage|Пробег

3021

|Duration|Продолжительность

3022

|Address|Адрес начального местоположения

3023

|Address2|Адрес конечного местоположения

3024

|name|Имя радиометки

3025

|rid|Номер радиометки

3026

|rguid|ID радиометки

3027

|trailer|Информация об агрегате

3028

|ModelGuid|ID агрегата

3029

|Number|Название/номер агрегата

3030

|Description|Текст примечания агрегата

3031

3032

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Карты-метки**(%%) =

3033

3034

== (% style="color:#000000; font-size:16px" %)**Получить список карт-меток определенного клиента**(%%) ==

3035

3036

(% class="box infomessage" %)

3037

(((

3038

**POST /api/v3/Rfids/find**

)))

Запрос:

{

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

}

Ответ:

[

{

"name": "string",

"number": 0,

"period": 0,

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3055

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3060

|parentId|ID клиента

3061

|name|Название карты-метки

3062

|number|Номер

3063

|period|Период запросов в секундах (работает только для агрегатов)

3064

|id|ID карты-метки

3065

3066

== (% style="color:#000000; font-size:16px" %)**Получить данные карты-метки**(%%) ==

3067

3068

(% class="box infomessage" %)

3069

(((

3070

**GET /api/v3/Rfids/{rfidGuid}**

3071

)))

3072

3073

Передаем параметр rfidGuid - идентификатор карты-метки

Ответ:

[

{

"name": "string",

"number": 0,

"period": 0,

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3083

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3088

|name|Название карты-метки

3089

|number|Номер

3090

|period|Период запросов в секундах (работает только для агрегатов)

|id|ID карты-метки

|parentId|ID клиента

== (% style="color:#000000; font-size:16px" %)**Добавить карту-метку**(%%) ==

3095

3096

(% class="box successmessage" %)

3097

(((

3098

**POST /api/v3/Rfids**

)))

Запрос:

{

"name": "string",

"number": 0,

"period": 0,

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

}

Ответ:

{

"name": "string",

"number": 0,

"period": 0,

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3117

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3118

}

3119

3120

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3121

|name|Название карты-метки

3122

|number|Номер

3123

|period|Период запросов в секундах (работает только для агрегатов)

|id|ID карты-метки

|parentId|ID клиента

== (% style="color:#000000; font-size:16px" %)**Редактировать карту-метку**(%%) ==

3128

3129

(% class="box warningmessage" %)

3130

(((

3131

**PUT /api/v3/Rfids**

)))

Запрос:

{

"name": "string",

"number": 0,

"period": 0,

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3141

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

}

Ответ:

{

"name": "string",

"number": 0,

"period": 0,

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3151

"parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3152

}

3153

3154

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3155

|name|Название карты-метки

3156

|number|Номер

3157

|period|Период запросов в секундах (работает только для агрегатов)

|id|ID карты-метки

|parentId|ID клиента

== (% style="color:#000000; font-size:16px" %)**Удалить карту-метку**(%%) ==

3162

3163

(% class="box errormessage" %)

3164

(((

3165

**DELETE /api/v3/Rfids/{rfidGuid}**

3166

)))

3167

3168

Передаем параметр **rfidGuid** - идентификатор карты-метки

Ответ:

Success

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Биллинг**(%%) =

3176

3177

== (% style="color:#000000; font-size:16px" %)**Узнать баланс клиента**(%%) ==

3178

3179

(% class="box infomessage" %)

3180

(((

3181

**GET /api/v3/Billing/client/balance/{clientId}**

3182

)))

3183

3184

Параметр запроса: **clientId **- идентификатор клиента.

Ответ:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Balance": 0

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3194

|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента

3195

|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса

3196

3197

== (% style="color:#000000; font-size:16px" %)**Узнать ограничения клиента**(%%) ==

3198

3199

(% class="box infomessage" %)

3200

(((

3201

**GET /api/v3/Billing/client/constraint/{clientId}**

3202

)))

3203

3204

Параметр запроса: **clientId **- идентификатор клиента.

Ответ:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3210

"CalculationType": 0,

3211

"PermissibleBalance": 0,

3212

"DefermentDays": 0,

3213

"SendUiNotifications": true,

3214

"SendEmailNotifications": true,

"IsPrivate": true,

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3219

|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента

3220

|(% style="width:215px" %)CalculationType|(% style="width:861px" %)Определяет тип расчёта, 0 - Деньги, 1 - Дни

3221

|(% style="width:215px" %)PermissibleBalance|(% style="width:861px" %)Допустимый баланс

3222

|(% style="width:215px" %)DefermentDays|(% style="width:861px" %)Отсрочка, количество дней.

3223

|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено

3224

|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено

3225

|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом

3226

3227

== (% style="color:#000000; font-size:16px" %)**Узнать состояние тарифного плана клиента**(%%) ==

3228

3229

(% class="box infomessage" %)

3230

(((

3231

**GET /api/v3/Billing/client/plan/{clientId}**

)))

Параметры запроса:

**clientId **- идентификатор клиента.

3237

3238

**planId **- идентификатор тарифного плана.

Ответ:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3244

"Plan": { **~/~/ Описание тарифного плана**

3245

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3246

"OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name": "string",

"IsArchived": true,

"Constraint": {

"CalculationType": 0,

3251

"PermissibleBalance": 0,

3252

"DefermentDays": 0

3253

},

3254

"Features": [ **~/~/ Описание шаблона услуг тарифного плана**

{

"Feature": "string",

"IsFactual": true,

"Limit": 0,

"Price": 0,

"PeriodValue": 0,

"PeriodType": 0

}

]

},

"DebitDate": "2023-10-18T12:46:24.213Z",

3266

"Features": [ **~/~/ Описание услуг тарифного плана как есть**

{

"Feature": "string",

"IsEnabled": true,

"IsPrivate": true,

"IsFactual": true,

"Limit": 0,

"Price": 0,

"DebitDate": "2023-10-18T12:46:24.213Z",

"PeriodValue": 0,

"PeriodType": 0

}

]

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3282

|ClientId|Идентификатор клиента

3283

|Id|Идентификатор тарифного плана

3284

|OwnerId|Идентификатор клиента-владельца

3285

|Name|Наименование тарифного плана

3286

|IsArchived|Признак, определяющий архивный тарифный план

3287

|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни

3288

|PermissibleBalance|Допустимый баланс

3289

|DefermentDays|Отсрочка, количество дней

3290

|Feature|Код услуги

3291

|IsEnabled|Признак, определяющий активирована ли услуга

3292

|IsPrivate|Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом.

3293

|IsFactual|Признак, определяющий расчёт по факту

3294

|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.

3295

|Price|Цена за единицу.

3296

|DebitDate|Следующий момент времени списания с баланса за услугу.

3297

|PeriodValue|Значение периода.

3298

|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы

3299

3300

== (% style="color:#000000; font-size:16px" %)**Получить тарифные планы принадлежащие клиенту**(%%) ==

3301

3302

(% class="box infomessage" %)

3303

(((

3304

**GET /api/v3/Billing/client/constraint/getowned/{clientId}**

3305

)))

3306

3307

Параметр запроса: **clientId **- идентификатор клиента.

Ответ:

[

{

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3314

"OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name": "string",

"IsArchived": true,

"Constraint": {

"CalculationType": 0,

3319

"PermissibleBalance": 0,

"DefermentDays": 0

},

"Features": [

{

"Feature": "string",

"IsFactual": true,

"Limit": 0,

"Price": 0,

"PeriodValue": 0,

"PeriodType": 0

}

]

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3336

|ClientId|Идентификатор клиента

3337

|Id|Идентификатор тарифного плана

3338

|OwnerId|Идентификатор клиента-владельца

3339

|Name|Наименование тарифного плана

3340

|IsArchived|Признак, определяющий архивный тарифный план

3341

|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни

3342

|PermissibleBalance|Допустимый баланс

3343

|DefermentDays|Отсрочка, количество дней

3344

|Feature|Код услуги

3345

|IsFactual|Признак, определяющий расчёт по факту

3346

|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.

3347

|Price|Цена за единицу.

3348

|PeriodValue|Значение периода.

3349

|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы

3350

3351

== (% style="color:#000000; font-size:16px" %)**Получить список доступных тарифных планов**(%%) ==

3352

3353

(% class="box infomessage" %)

3354

(((

3355

**GET /api/v3/Billing/client/constraint/getowned/{clientId}**

3356

)))

3357

3358

Параметр запроса: **clientId **- идентификатор клиента.

Ответ:

[

{

"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3365

"OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Name": "string",

"IsArchived": true,

"Constraint": {

"CalculationType": 0,

3370

"PermissibleBalance": 0,

"DefermentDays": 0

},

"Features": [

{

"Feature": "string",

"IsFactual": true,

"Limit": 0,

"Price": 0,

"PeriodValue": 0,

"PeriodType": 0

}

]

}

]

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3387

|ClientId|Идентификатор клиента

3388

|Id|Идентификатор тарифного плана

3389

|OwnerId|Идентификатор клиента-владельца

3390

|Name|Наименование тарифного плана

3391

|IsArchived|Признак, определяющий архивный тарифный план

3392

|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни

3393

|PermissibleBalance|Допустимый баланс

3394

|DefermentDays|Отсрочка, количество дней

3395

|Feature|Код услуги

3396

|IsFactual|Признак, определяющий расчёт по факту

3397

|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.

3398

|Price|Цена за единицу.

3399

|PeriodValue|Значение периода.

3400

|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы

3401

3402

== (% style="color:#000000; font-size:16px" %)**Изменить баланс**(%%) ==

3403

3404

(% class="box warningmessage" %)

3405

(((

3406

**PUT /api/v3/Billing/client/balance**

3407

)))

3408

3409

Устанавливает указанное значение баланса не создавая операции пополнение/снятие.

Тело запроса:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Balance": 0

}

Ответ: Success

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3421

|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента

3422

|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса

3423

3424

== (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) ==

3425

3426

(% class="box warningmessage" %)

3427

(((

3428

**PUT /api/v3/billing/client/balance/deposit**

3429

)))

3430

3431

Создает операцию **Пополнение **с указанной суммой

Тело запроса:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Balance": 0

}

Ответ: Success

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3443

|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента

3444

|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса

3445

3446

== (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) ==

3447

3448

Создает операцию **Списание **с указанной суммой

3449

3450

(% class="box warningmessage" %)

3451

(((

3452

**PUT /api/v3/billing/client/balance/withdraw**

)))

Тело запроса:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Balance": 0

}

Ответ: Success

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3465

|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента

3466

|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса

3467

3468

== (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) ==

3469

3470

(% class="box warningmessage" %)

3471

(((

3472

**PUT /api/v3/Billing/client/constraint**

)))

Тело запроса:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3479

"CalculationType": 0,

3480

"PermissibleBalance": 0,

3481

"DefermentDays": 0,

3482

"SendUiNotifications": true,

3483

"SendEmailNotifications": true,

"IsPrivate": true,

}

Ответ: Success

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3490

|ClientId|Идентификатор клиента

3491

|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни

3492

|PermissibleBalance|Допустимый баланс

3493

|DefermentDays|(((

3494

Отсрочка, количество дней

3495

)))

3496

|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено

3497

|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено

3498

|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом

3499

3500

== (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) ==

3501

3502

(% class="box warningmessage" %)

3503

(((

3504

**PUT /api/v3/Billing/client/plan**

)))

Тело запроса:

{

"ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3511

"PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"Features": [

{

"Feature": "string",

"IsEnabled": true,

"IsFactual": true,

"Limit": 0,

"Price": 0,

"DebitDate": "2023-10-18T13:26:58.987Z",

"PeriodValue": 0,

"PeriodType": 0

}

]

}

Ответ: Success

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3529

|ClientId|Идентификатор клиента

3530

|PlanId|Идентификатор тарифного плана

3531

|Feature|Код услуги

3532

|IsEnabled|Признак, определяющий активирована ли услуга

3533

|IsFactual|Признак, определяющий расчёт по факту

3534

|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.

3535

|Price|Цена за единицу.

3536

|DebitDate|Следующий момент времени списания с баланса за услугу.

3537

|PeriodValue|Значение периода.

3538

|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы

3539

3540

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) =

3541

3542

(% class="box warningmessage" %)

3543

(((

3544

Для тестирования запросов **Импорта **в Postman необходимо скачать его на ПК. Версия в браузере не позволяет загружать файлы в тело запроса.

3545

)))

3546

3547

== (% style="color:#000000; font-size:16px" %)**Импорт объектов**(%%) ==

3548

3549

(% class="box infomessage" %)

3550

(((

3551

**POST /api/v3/vehicles/import/{agentId}**

3552

)))

3553

3554

Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.**

3555

3556

В пути указывается **agentId** - id клиента.

**Заголовок**

**X-Auth: [токен авторизации]**

**Параметры**

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3565

|withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать.

3566

|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление

3567

3568

В теле использовать тип **form-data,** тип значения** file**

**Ключи**

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3573

|data|В значении передаем файл объекта, формат **xml** или **wlp **

3574

|csv|В значении передаем файл датчиков, формат **csv**

Ответ:

{

"vehicleId": 0,

"name": "string",

"errors": ["string"]

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3585

|vehicleId|ID созданного объекта

3586

|name|Имя созданного объекта

3587

|errors|Ошибки и их описание

3588

3589

== (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) ==

3590

3591

(% class="box infomessage" %)

3592

(((

3593

**POST** **/api/v3/vehicles/import/history/{vehicleId}**

3594

)))

3595

3596

(% class="wikigeneratedid" %)

3597

Позволяет импортировать сообщения в выбранный объект. Сообщения должны иметь формат **wln** или **json**. Также они могут быть упакованы и переданы в виде в **zip-архива**.

3598

3599

(% class="wikigeneratedid" %)

3600

В пути указывается **vehicleId **- id объекта.

**Заголовок**

**X-Auth: [токен авторизации]**

3605

3606

В теле использовать тип **form-data.**

Ключи:

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3611

|**history**|В значении передавать файл с историей

3612

3613

В случае, если загружается история из файла **wln **можно выполнять подмену названий параметров. В ключе вы указываете название параметра из файла, в значении указываете значение на которое нужно заменить.

Ответ:

{

"results": [

{

"vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"vehicleId": 0,

"errors": [

"string"

],

"firstMessageDate": "2023-11-28T09:27:58.949Z",

3626

"lastMessageDate": "2023-11-28T09:27:58.949Z",

"producedCount": 0,

"msgCount": 0

}

]

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3634

|results|Результаты импорта в разрезе ТС

3635

|vehicleGuid|Guid ТС

3636

|vehicleId|ID ТС

3637

|errors|Список ошибок импорта истории (если пустой - нет ошибок)

3638

|firstMessageDate|Дата первого импортированного сообщения (UTC)

3639

|lastMessageDate|Дата последнего импортированного сообщения (UTC)

3640

|producedCount|Кол-во успешно отправленных в шину данных сообщений

3641

|msgCount|Кол-во обработанных сообщений всего

3642

3643

== (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==

3644

3645

(% class="box infomessage" %)

3646

(((

3647

**GET /api/v3/vehicles/import/history/status**

3648

)))

3649

3650

Запрос статуса импорта истории. Может потребоваться в случае импорта истории за большой период.

Ответ:

{

"activity": true,

"progress": 0,

"message": "string"

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3661

|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет

3662

|progress|Guid ТС

3663

3664

== (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==

3665

3666

(% class="box infomessage" %)

3667

(((

3668

**POST /api/v3/vehicles/export**

3669

)))

3670

3671

Запрос позволяет экспортировать файлы с настройками объектов. В запросе передается массив id объектов.

Тело запроса:

[

id

]

Ответ: Success 200, получаете файлы с настройками.

3680

3681

== (% style="color:#000000; font-size:16px" %)**Экспорт сообщений**(%%) ==

3682

3683

(% class="box infomessage" %)

3684

(((

3685

**POST /api/v3/vehicles/export/history**

3686

)))

3687

3688

Метод возвращает список сообщений терминала объекта за выбранный период.

Тело запроса:

{

"vehicleId": 0,

"asArchive": true,

"from": "2023-09-27T12:17:45.973Z",

3696

"to": "2023-09-27T12:17:45.973Z"

}

Ответ:

Получаете файл. Сообщение: Code 200/Success

3702

3703

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3704

|vehicleId|ID объекта

3705

|asArchive|true - Архивировать файл, False - не архивировать

3706

|from|Дата и время начала запроса

3707

|to|Дата и время окончания запроса

3708

3709

== (% style="color:#000000; font-size:16px" %)**Статус экспорта сообщений**(%%) ==

3710

3711

(% class="box infomessage" %)

3712

(((

3713

**GET /api/v3/vehicles/export/history/status**

3714

)))

3715

3716

Метод возвращает список сообщений терминала объекта за выбранный период.

Ответ:

{

"activity": true,

"progress": 0,

"message": "string"

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3727

|activity|Статус экспорта, где true - экспорт в процессе выполнения, false - в данный момент ничего не экспортируется.

3728

|progress|Прогресс экспорта, от 0 до 100%

3729

|message|Текст описывающий статус

3730

3731

= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) =

3732

3733

== (% style="color:#000000; font-size:16px" %)**Запрос рейтинша качества вождения**(%%) ==

3734

3735

(% class="box infomessage" %)

3736

(((

3737

**POST /api/v3/EcoDriving/rating**

3738

)))

3739

3740

Позволяет получить данные рейтинга нарушений выбранных объектов за указанный период времени. Данные, выдаваемые этим запросом аналогичны тем, что вы можете увидеть в окне **Качество вождения** в мониторинге. В массиве **items **передается список объектов из рейтинга качества вождения, в **trips **передается информация по отдельным рейсам объекта.

Тело запроса:

{

"vehicleIds": [vehicleId],

3746

"from": "2023-11-22T09:29:48.051Z",

3747

"to": "2023-11-22T09:29:48.051Z"

3748

}

3749

3750

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3751

|vehicleIds|Массив ID объектов

3752

|from|Дата начала запроса

3753

|to|Дата окончания запроса

Ответ:

{

"items": [

{

"from": "2023-11-22T09:29:48.052Z",

3761

"to": "2023-11-22T09:29:48.052Z",

3762

"vehicleId": 0,

3763

"vehicleName": "string",

3764

"vehicleModel": "string",

3765

"penalty": 0,

3766

"score": 0,

3767

"totalViolations": 0,

3768

"violationsByType": {

3769

"overspeedingViolations": 0,

3770

"accelerationViolations": 0,

3771

"brakingViolations": 0,

3772

"turningViolations": 0,

3773

"dangerousDrivingViolations": 0,

3774

"sensorViolations": 0

},

"moveTime": 0,

"mileage": 0,

"tripsCount": 0,

"trips": [

{

"penalty": 0,

"score": 0,

"violationsCount": 0,

3784

"violationsByType": {

3785

"overspeedingViolations": 0,

3786

"accelerationViolations": 0,

3787

"brakingViolations": 0,

3788

"turningViolations": 0,

3789

"dangerousDrivingViolations": 0,

3790

"sensorViolations": 0

},

"moveTime": 0,

"mileage": 0,

"motohours": 0,

"maxSpeed": 0,

"startAddress": "string",

3797

"endAddress": "string",

3798

"drivers": [

3799

{

3800

"driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

3801

"driverName": "string",

3802

"driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

}

]

}

]

}

]

}

|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**

3812

|from|Дата начала запроса

3813

|to|Дата окончания

3814

|vehicleId|ID объекта

3815

|vehicleName|Имя объекта

3816

|vehicleModel|Модель объекта

3817

|penalty|Сумма штрафных баллов

3818

|score|Оценка

3819

|totalViolations|Суммарное количество нарушений

3820

|violationsByType|Список типов нарушений и количество нарушений для каждого типа

3821

|overspeedingViolations|Превышение скорости

3822

|accelerationViolations|Ускорение

3823

|brakingViolations|Торможение

3824

|turningViolations|Резкий поворот

3825

|dangerousDrivingViolations|Резкое вождение

3826

|sensorViolations|Нарушение по датчику

3827

|moveTime|Время в движении

3828

|mileage|Пробег

3829

|tripsCount|Количество рейсов

3830

|motohours|Моточасы

3831

|maxSpeed|Максимальная скорость

3832

|startAddress|Адрес начала рейса

3833

|endAddress|Адрес окончания рейса

3834

|drivers|Список водителей, которые были на объекте в течениии рейса

3835

|driverGuid|Guid водителя

3836

|driverName|Имя водителя

3837

|driverRfid|Номер Карты-метки

3838

3839

(% class="box" lang="en-US" style="text-align: center;" %)

3840

(((

3841

(% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **

3842

)))

Wiki source code of Методы API для работы с ГЛОНАССSoft

Меню