IntraDesk API. Обновление пользователя сотрудника
Каждый запрос к IntraDesk API должен содержать токен авторизации в заголовке authorization, см. Статья №1229
PUT https://apigw.intradesk.ru/settings/api/Employees
Headers:
content-type: application/json
authorization: Bearer {указываем_токен_доступа}
Body
Обязательно указание поля "id" - идентификатора пользователя сотрудника для изменения, а также поля "updatedAt" - дата последнего изменения сотрудника (можно получить при запросе на получение сотрудника через запрос Статья №4741 )
При запросе необходимо передавать все поля. Поля, которые не будут переданы, обнулятся.
Пример изменения пользователя сотрудника с id=13 Иванова Аркадия, у которого не заданы телефоны и дополнительные поля. Меняем ему пароль
{
"id": 13,
"updatedAt": "2021-04-19T16:52:52.3034220Z"
"firstName": "Иванов",
"lastName":"Аркадий",
"email":"ivanov.arkadii@tesgroup.ru",
"password": "mypasswordchange",
"roleid": 350,
"phoneNumbers":[]
}
Формат body для запроса на создание
"firstName" - строка, имя пользователя
"lastName" - строка, фамилия пользователя
"email" - строка, емейл пользователя
"roleId" – число, идентификатор роли пользователя сотрудника
"password" - строка, пароль пользователя
"FieldIdValues" - массив, значения дополнительных полей. Если не заданы, нужно послать пустой массив. Подробнее о формате ниже в Формат значений дополнительных полей.
"phoneNumbers" - массив, телефоны пользователя. Если не заданы, нужно послать пустой массив. Подробнее о формате ниже в Формат телефона.
"middleName" – строка, отчество пользователя сотрудника
"userGroups" – массив, группы пользователя (привязка к существующим группа). Подробнее о формате ниже в Формат привязки группы к пользователю сотруднику
"userTags" – массив, теги сотрудника. Подробнее о формате ниже в Формат тегов
"isArchived" – булевый признак, удален ли сотрдуник (заархивирован)
"fotoImage" - изображение в base64, фото пользователя (формат "data:image/png;base64, {base64stringContent}"). Чтобы обновилось, необходимо также передать флаг "isNewFoto"
"isNewFoto" - булевый признак, флаг на изменение фото сотрудника
Формат значений дополнительных полей
"id"- число, идентификатор дополнительного поля сотрудника
"value" - строка, значение дополнительного поля
"type" - число, тип дополнительного поля (Number (число) = 1, String (строка) = 2, SingleSelect (выпадающий список, одно значение)= 3, DateTime (дата) = 4, Boolean (да\нет) = 5, File (файл) = 6, Text (текст) = 7, MultiSelect (множественный выбор) = 8)
Формат телефона
"phoneNumber" - строка, номер телефона, только 10 цифр (без кода страны)
"default" - булевый признак, по умолчанию или нет (может быть только один по умолчанию)
Формат привязки группы к пользователю сотруднику
"id" - число, идентификатор группы
Формат тегов
"id" - число, идентификатор тега