IntraDesk API. Обновление пользователя клиента
Каждый запрос к IntraDesk API должен содержать токен авторизации в заголовке authorization, см. Статья №1229
PUT https://apigw.intradesk.ru/settings/api/Clients
Headers:
content-type: application/json
authorization: Bearer {указываем_токен_доступа}
Body
Обязательно указание поля "id" - идентификатора пользователя клиента для изменения, а также поля "updatedAt" - дата последнего изменения клиента (можно получить при запросе на получение клиента через запроса Статья №4743 )
При запросе необходимо передавать все поля. Поля, которые не будут переданы, обнулятся.
Пример изменения пользователя клиента с id=13 Петрова Аркадия с ролью roleid=13, находящегося в компании с id=353, у которого не заданы телефоны и дополнительные поля.
Меняем ему пароль на "mypass45", задаем телефон 495-234-21-23
{
"firstName": "Петров",
"lastName":"Аркадий",
"email":"petrov.arkadii@testcomp.ru",
"roleId": 13,
"userGroups":[{"isDefault":true,"id":353}],
"phoneNumbers":[{"phoneNumber": "4952342123", "isDefault": true}],
"password": "mypass45",
}
Формат 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" - число, идентификатор компании
"isDefault" - булевый признак, основная компания или нет (может быть только одна)
Формат тегов
"id" - число, идентификатор тега