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 - Пользователь не найден