Пользователи

1. Метод GETUSERS

Возвращает информацию о пользователях.

URL: http://gateway.workaud.com/extapi/getusers

Параметры

Название параметраОписание
id Перечисленные через запятую ID пользователей. Максимум 1000 пользователей. 0-вывод всех пользователей в данной компании.
login Логин пользователя
statusid Статус пользователя(-ей) (5 – не активирован, 10 – активен, 20 – заблокирован)
fields

Перечислены поля через запятую которые нужно вернуть. Доступные поля: id, login, statusid,FirstName, LastName, MiddleName, Phone, CoordX, CoordY, Birthday, LastLocationDateTime, TimeZoneId, BatteryLevel,Roles

 

Ответ

XML

<Result>
<ErrorCode> int | код ошибки </ErrorCode>
<Data>
<User>
<Id> int | идентификатор</Id>
<StatusId> int | статус </StatusId>
<Login> string | логин </Login>
<FirstName> string | Имя</FirstName>
<LastName> string | Фамилия</LastName>
<MiddleName> string | Отчество</MiddleName>
<Phone> string | Телефон</Phone>
<CoordX>double | Долгота местоположения </CoordX>
<CoordY> double | Широта местоположения </CoordY>
<Birthday> date? | День рождения</ Birthday >
<LastLocationDateTime> date? | Последнее время определения местоположения</LastLocationDateTime>
<BatteryLevel> int | уровень заряда батареи </BatteryLevel>
<TimeZoneI> string | Идентификатор временной зоны</TimeZoneId>
<Roles>
<RoleId>int | идентификатор роли</RoleId>

</Roles>
</User>

</Data>
</Result>

 

JSON

{"ErrorCode":0,"Data":[{"Id":<int|идентификатор>, "StatusId":<int|статус>, "Login":<string|логин>, "FirstName":<string|имя>, "LastName":<string|фамилия>, "MiddleName":<string|отчество>, "Phone":<string|телефон>, "CoordX":<double|Долгота местоположения>, "CoordY":<double | Широта местоположения>, "Birthday":<дата | День рождения>, "LastLocationDateTime":<date? | Последнее время определения местоположения>, "BatteryLevel":<int | уровень заряда батареи>, "TimeZoneId":<string | Идентификатор временной зоны >,
"Roles":[<int|идентификатор роли>,…]},…]}

 2. Метод UPDATEUSER

Устанавливает информацию о пользователях.

URL: http://gateway.workaud.com/extapi/updateuser

 Параметры

Название параметраОписание
id Идентификатор пользователя. Обязательный параметр.
  Поля которые можно заменить:  statusid,FirstName, LastName, MiddleName, Phone, Birthday.

 

Ответ

XML

<Result>
<ErrorCode> int | код ошибки </ErrorCode>
<Data> string | сообщение об ошибке</Data>
</Result>

JSON

{"ErrorCode":<int | код ошибки>,"Data":< string | сообщение об ошибке >}

Возможные коды ошибок:

-1  - Пользователь не найден

 3. Метод ADDUSERROLES

Добавляет роли к пользователю.

URL: http://gateway.workaud.com/extapi/adduserroles

Параметры

Название параметраОписание
id Идентификатор пользователя. Обязательный параметр.
roles Перечисленные через запятую идентификаторы ролей. Обязательный параметр.

 

Ответ

XML

<Result>
<ErrorCode> int | код ошибки </ErrorCode>
<Data> string | сообщение об ошибке</Data>
</Result>

JSON

{"ErrorCode":<int | код ошибки>,"Data":< string | сообщение об ошибке >}

Возможные коды ошибок:

-1  - Пользователь не найден

4. Метод DELETEUSERROLES

Удаляет роли у пользователя.

URL: http://gateway.workaud.com/extapi/deleteuserroles

Параметры

Название параметраОписание
id Идентификатор пользователя. Обязательный параметр.
roles Перечисленные через запятую идентификаторы ролей. Обязательный параметр.

 

Ответ

XML

<Result>
<ErrorCode> int | код ошибки </ErrorCode>
<Data> string | сообщение об ошибке</Data>
</Result>



JSON

{"ErrorCode":<int | код ошибки>,"Data":< string | сообщение об ошибке >}

Возможные коды ошибок:

-1  - Пользователь не найден