Событие при удалении приложения onAppUninstall

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: базовый

Кто может подписаться: любой пользователь

Событие ONAPPUNINSTALL вызывается при удалении приложения.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения.

Что получает обработчик

Данные передаются в виде POST-запроса

{
    "event": "ONAPPUNINSTALL",
    "event_handler_id": "13",
    "data": {
        "LANGUAGE_ID": "ru",
        "CLEAN": "1"
    },
    "ts": "1466439714",
    "auth": {
        "domain": "some-domain.bitrix24.ru",
        "server_endpoint": "https://oauth.bitrix24.tech/rest/",
        "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
        "member_id": "a223c6b3710f85df22e9377d6c4f7553",
        "application_token": "51856fefc120afa4b628cc82d3935cce"
    }
}

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

Обязательные параметры отмечены *

Название
тип

Описание

event*
string

Символьный код события — ONAPPUNINSTALL

event_handler_id
integer

Идентификатор обработчика события

data*
object

Данные об удаленном приложении.

Структура описана ниже

ts*
timestamp

Дата и время отправки события из очереди

auth*
object

Объект с параметрами авторизации и данными о Битрикс24, на котором произошло событие.

Структура описана ниже

Параметр data

Название
тип

Описание

LANGUAGE_ID*
string

Язык Битрикс24 по умолчанию: ru, en и другие

CLEAN*
integer

Значение опции «Очистить данные приложения», которая задается пользователем при удалении приложения. Значения: 1 или 0

Параметр auth

Название
тип

Описание

domain*
string

Адрес Битрикс24, на котором произошло событие

server_endpoint*
string

Адрес сервера авторизации для обновления токена

client_endpoint*
string

Общий путь для вызовов методов API Битрикс24

member_id*
string

Уникальный идентификатор Битрикс24

application_token*
string

Токен приложения. Сравните его с токеном, сохраненным при установке, чтобы убедиться, что запрос пришел из Битрикс24. Подробнее — в статье Безопасность в обработчиках

Токены в auth не передаются, а права приложения на API при удалении снимаются. Вызвать методы API из обработчика этого события нельзя.

Продолжите изучение

Предыдущая
После обновления приложения
Следующая
При оплате приложения