метод REST scope: placement

placement.unbind

Удалить обработчик виджета

Кто может выполнять: администратор, авторизованный в приложении

Описание

Метод placement.unbind удаляет зарегистрированный обработчик виджета.

Метод работает только в контексте приложения.

Параметры

PLACEMENT string необязательный

Код точки встраивания.

PLACEMENT можно получить:
- методом placement.list
- методом placement.get в поле placement

HANDLER string необязательный

URL обработчика виджета.

HANDLER можно получить методом placement.get в поле handler.

Если параметр не передан или передан пустым, метод удаляет все обработчики указанной точки встраивания, зарегистрированные приложением

USER_ID integer необязательный

Идентификатор пользователя Битрикс24, для которого был зарегистрирован обработчик.

USER_ID можно получить:
- методом user.get
- методом user.current для текущего пользователя

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

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "PLACEMENT": "CRM_LEAD_DETAIL_TAB",
    "HANDLER": "https://www.myapplicationhost.com/placement/",
    "auth": "**put_access_token_here**"
  }' \
  "https://**put.your-domain-here**/rest/placement.unbind.json"

Ответ

HTTP-статус: 200

{
    "result": {
        "count": 4
    },
    "time": {
        "start": 1775058296,
        "finish": 1775058296.998083,
        "duration": 0.9980831146240234,
        "processing": 0,
        "date_start": "2026-04-01T18:44:56+03:00",
        "date_finish": "2026-04-01T18:44:56+03:00",
        "operating_reset_at": 1775058896,
        "operating": 0
    }
}

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

result object

Объект с результатом удаления:

  • count integer — число, которое метод увеличивает:
    - на 1 при каждой найденной записи обработчика перед вызовом удаления
    - еще на 1 после каждого успешного удаления
time time

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

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

HTTP-статус: 403

{
    "error": "WRONG_AUTH_TYPE",
    "error_description": "Current authorization type is denied for this method Application context required"
}
Код Описание Значение
403 WRONG_AUTH_TYPE Current authorization type is denied for this method Application context required
403 ACCESS_DENIED Access denied!
400 ERROR_ARGUMENT Argument 'PLACEMENT' is null or empty
400 ERROR_ARGUMENT The value of an argument 'PLACEMENT' must be of type string

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.