Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Обновить данные пользователя user.update». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.
Обновить данные пользователя user.update
> Scope: user
>
> Кто может выполнять метод: администратор
Метод user.update обновляет данные пользователя. Возможно только от имени пользователя с правами приглашения пользователей.
Параметры метода
Названиетип | Описание |
|---|---|
ID*integer | Идентификатор пользователя |
ACTIVEboolean | Признак активности пользователя. Возможные значения: — Y — сотрудник активен,— N — сотрудник уволен |
EMAILstring | E-mail пользователя |
NAMEstring | Имя |
LAST_NAMEstring | Фамилия |
SECOND_NAMEstring | Отчество |
PERSONAL_GENDERstring | Пол |
PERSONAL_PROFESSIONstring | Профессия |
PERSONAL_WWWstring | Домашняя страничка |
PERSONAL_BIRTHDAYstring | Дата рождения |
PERSONAL_PHOTOarray | Фотография, передавайте массив из имени файла и строки с Bаse64 |
PERSONAL_ICQstring | ICQ |
PERSONAL_PHONEstring | Личный телефон |
PERSONAL_FAXstring | Факс |
PERSONAL_MOBILEstring | Личный мобильный |
PERSONAL_PAGERstring | Пейджер |
PERSONAL_STREETstring | Улица проживания |
PERSONAL_CITYstring | Город проживания |
PERSONAL_STATEstring | Область / край |
PERSONAL_ZIPstring | Почтовый индекс |
PERSONAL_COUNTRYstring | Страна |
PERSONAL_MAILBOXstring | Почтовый ящик |
PERSONAL_NOTESstring | Дополнительные заметки |
WORK_PHONEstring | Телефон компании |
WORK_COMPANYstring | Компания |
WORK_POSITIONstring | Должность |
WORK_DEPARTMENTstring | Отдел |
WORK_WWWstring | Сайт компании |
WORK_FAXstring | WORK_FAX |
WORK_PAGERstring | WORK_PAGER |
WORK_STREETstring | WORK_STREET |
WORK_MAILBOXstring | WORK_MAILBOX |
WORK_CITYstring | Город работы |
WORK_STATEstring | WORK_STATE |
WORK_ZIPstring | WORK_ZIP |
WORK_COUNTRYstring | WORK_COUNTRY |
WORK_PROFILEstring | WORK_PROFILE |
WORK_LOGOarray | WORK_LOGO |
WORK_NOTESstring | WORK_NOTES |
UF_SKYPE_LINKstring | Ссылка на чат в Skype |
UF_ZOOMstring | Zoom |
UF_DEPARTMENTstring | Подразделения |
UF_INTERESTSstring | Интересы |
UF_SKILLSstring | Навыки |
UF_WEB_SITESstring | Другие сайты |
UF_XINGstring | |
UF_LINKEDINstring | |
UF_fbstring | fb |
UF_TWITTERstring | |
UF_SKYPEstring | Skype |
UF_DISTRICTstring | Район |
UF_PHONE_INNERstring | Внутренний телефон |
Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.
Примеры кода
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"ID": 1,
"NAME": "Administrator",
"LAST_NAME": "SomeLastName"
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/user.update- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"ID": 1,
"NAME": "Administrator",
"LAST_NAME": "SomeLastName",
"auth": "**put_access_token_here**"
}' \
https://**put_your_bitrix24_address**/rest/user.update- JS
try
{
const response = await $b24.callMethod(
"user.update",
{
"ID": 1,
"NAME": "Administrator",
"LAST_NAME": "SomeLastName"
}
);
const result = response.getData().result;
if(result.error())
{
console.error(result.error());
}
else
{
console.dir(result);
}
}
catch(error)
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->core
->call(
'user.update',
[
'ID' => 1,
'NAME' => 'Administrator',
'LAST_NAME' => 'SomeLastName',
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating user: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"user.update",
{
"ID": 1,
"NAME": "Administrator",
"LAST_NAME": "SomeLastName"
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.dir(result.data());
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'user.update',
[
'ID' => 1,
'NAME' => 'Administrator',
'LAST_NAME' => 'SomeLastName'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1721807581.02493,
"finish": 1721807581.20039,
"duration": 0.17546010017395,
"processing": 0.133708000183105,
"date_start": "2024-07-24T07:53:01+00:00",
"date_finish": "2024-07-24T07:53:01+00:00",
"operating": 0.133685827255249
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultboolean | Успешность выполнения |
timetime | Информация о времени выполнения запроса |
Обработка ошибок
HTTP-статус: 400
{
"error": "ERROR_CORE",
"error_description": "access_denied"
}Возможные коды ошибок
| Код | Cообщение об ошибке | Описание |
|---|---|---|
ERROR_CORE | access_denied | Передан неверный ID пользователя |
ERROR_CORE | access_denied | У пользователя нет прав на вызов метода |
ERROR_CORE | Передан неверный ID пользователя |
- [](./user-add)
- [](./user-get)
- [](./user-current)
- [](./user-search)
- [](./user-fields)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Обновить данные пользователя user.update» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru