Блог Горошко Андрея Bitrix24,PHP Сбросить параметры карточки crm.contact.details.configuration.reset

Сбросить параметры карточки crm.contact.details.configuration.reset

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

Сбросить параметры карточки crm.contact.details.configuration.reset

> Scope: crm
>
> Кто может выполнять метод:
> — Любой пользователь имеет право получать свои и общие настройки
> — Только администратор имеет право получать чужие настройки

Метод сбрасывает настройки карточки контактов: удаляет личные настройки карточки указанного пользователя или общие настройки, заданные для всех пользователей.

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

Название
тип
Описание
scope
string
Область применения настроек.

Возможные значения:
— P — личные настройки
— C — общие настройки

По умолчанию — P

userId
user
Идентификатор пользователя. Нужен только при сбросе личных настроек.

Если не задан, то берется id текущего пользователя

Примеры кода

1. Сбросить общую конфигурацию

  • cURL (Webhook)
        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"scope":"C"}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.contact.details.configuration.reset
  • cURL (OAuth)
        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"scope":"C","auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.contact.details.configuration.reset
  • JS
        BX24.callMethod(
            'crm.contact.details.configuration.reset',
            {
                scope: "C",
            },
            (result) => {
                result.error()
                    ? console.error(result.error())
                    : console.info(result.data())
                ;
            },
        );
  • PHP
        require_once('crest.php');

        $result = CRest::call(
            'crm.contact.details.configuration.reset',
            [
                'scope' => 'C'
            ]
        );

        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

2. Сбросить личную конфигурацию

  • cURL (Webhook)
        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"scope":"P","userId":6}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.contact.details.configuration.reset
  • cURL (OAuth)
        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"scope":"P","userId":6,"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.contact.details.configuration.reset
  • JS
        BX24.callMethod(
            'crm.contact.details.configuration.reset',
            {
                scope: "P",
                userId: 6,
            },
            (result) => {
                result.error()
                    ? console.error(result.error())
                    : console.info(result.data())
                ;
            },
        );
  • PHP
        require_once('crest.php');

        $result = CRest::call(
            'crm.contact.details.configuration.reset',
            [
                'scope' => 'P',
                'userId' => 6
            ]
        );

        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1724682584.069094,
        "finish": 1724682584.38436,
        "duration": 0.31526613235473633,
        "processing": 0.025727033615112305,
        "date_start": "2024-08-26T16:29:44+02:00",
        "date_finish": "2024-08-26T16:29:44+02:00",
        "operating": 0
    }
}

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

Название
тип
Описание
result
boolean
Корневой элемент ответа.

Возвращает true в случае успешного сброса настроек

time
time
Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Access denied."
}

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

КодОписаниеЗначение
Пустое значениеAccess denied.У пользователя нет административных прав
  • [](./index)
  • [](./crm-contact-details-configuration-get)
  • [](.//crm-contact-details-configuration-set)
  • [](./crm-contact-details-configuration-force-common-scope-for-all)

💡 Экспертное мнение и рекомендации

Ключевые выводы по теме «Сбросить параметры карточки crm.contact.details.configuration.reset»:

Использование современных стандартов D7 при работе с crm.contact.details.configuration.reset позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Получить поля пользователя user.fieldsПолучить поля пользователя user.fields

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить поля пользователя user.fields», проанализируем лучшие практики и

Получить список значений свойств sale.propertyvalue.listПолучить список значений свойств sale.propertyvalue.list

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

Создать новый поток tasks.flow.Flow.createСоздать новый поток tasks.flow.Flow.create

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