Блог Горошко Андрея Bitrix24 Обновить данные пользователя user.update

Обновить данные пользователя user.update

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Обновить данные пользователя user.update». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Обновить данные пользователя user.update

> Scope: user
>
> Кто может выполнять метод: администратор

Метод user.update обновляет данные пользователя. Возможно только от имени пользователя с правами приглашения пользователей.

Параметры метода

Название
тип
Описание
ID*
integer
Идентификатор пользователя
ACTIVE
boolean
Признак активности пользователя. Возможные значения:
— Y — сотрудник активен,
— N — сотрудник уволен
EMAIL
string
E-mail пользователя
NAME
string
Имя
LAST_NAME
string
Фамилия
SECOND_NAME
string
Отчество
PERSONAL_GENDER
string
Пол
PERSONAL_PROFESSION
string
Профессия
PERSONAL_WWW
string
Домашняя страничка
PERSONAL_BIRTHDAY
string
Дата рождения
PERSONAL_PHOTO
array
Фотография, передавайте массив из имени файла и строки с Bаse64
PERSONAL_ICQ
string
ICQ
PERSONAL_PHONE
string
Личный телефон
PERSONAL_FAX
string
Факс
PERSONAL_MOBILE
string
Личный мобильный
PERSONAL_PAGER
string
Пейджер
PERSONAL_STREET
string
Улица проживания
PERSONAL_CITY
string
Город проживания
PERSONAL_STATE
string
Область / край
PERSONAL_ZIP
string
Почтовый индекс
PERSONAL_COUNTRY
string
Страна
PERSONAL_MAILBOX
string
Почтовый ящик
PERSONAL_NOTES
string
Дополнительные заметки
WORK_PHONE
string
Телефон компании
WORK_COMPANY
string
Компания
WORK_POSITION
string
Должность
WORK_DEPARTMENT
string
Отдел
WORK_WWW
string
Сайт компании
WORK_FAX
string
WORK_FAX
WORK_PAGER
string
WORK_PAGER
WORK_STREET
string
WORK_STREET
WORK_MAILBOX
string
WORK_MAILBOX
WORK_CITY
string
Город работы
WORK_STATE
string
WORK_STATE
WORK_ZIP
string
WORK_ZIP
WORK_COUNTRY
string
WORK_COUNTRY
WORK_PROFILE
string
WORK_PROFILE
WORK_LOGO
array
WORK_LOGO
WORK_NOTES
string
WORK_NOTES
UF_SKYPE_LINK
string
Ссылка на чат в Skype
UF_ZOOM
string
Zoom
UF_DEPARTMENT
string
Подразделения
UF_INTERESTS
string
Интересы
UF_SKILLS
string
Навыки
UF_WEB_SITES
string
Другие сайты
UF_XING
string
Xing
UF_LINKEDIN
string
LinkedIn
UF_fb
string
fb
UF_TWITTER
string
Twitter
UF_SKYPE
string
Skype
UF_DISTRICT
string
Район
UF_PHONE_INNER
string
Внутренний телефон

Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.

Примеры кода

  • 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
        }
    }

Возвращаемые данные

Название
тип
Описание
result
boolean
Успешность выполнения
time
time
Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "ERROR_CORE",
    "error_description": "access_denied"
}

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

КодCообщение об ошибкеОписание
ERROR_COREaccess_deniedПередан неверный ID пользователя
ERROR_COREaccess_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 и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Как использовать метод SDK sale.propertyvariant.add в Битрикс24Как использовать метод SDK sale.propertyvariant.add в Битрикс24

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Как использовать метод SDK sale.propertyvariant.add в Битрикс24». Вы узнаете экспертные методики работы с

Получить список участников группы sonet_group.user.getПолучить список участников группы sonet_group.user.get

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Получить список участников группы sonet_group.user.get», разберем архитектурные особенности

Получить значения параметра свойства товаров или вариаций catalog.productProp…Получить значения параметра свойства товаров или вариаций catalog.productProp…

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Получить значения параметра свойства товаров или вариаций catalog.productProp…»,