метод REST scope: crm

crm.activity.badge.add

Добавить бейдж

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

Описание

Метод crm.activity.badge.add добавляет новый бейдж для конфигурируемого дела.

Параметры

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

Код бейджа, например missedCall

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

Заголовок бейджа. Может быть строкой или массивом строк для разных языков

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

Заголовок бейджа. Может быть строкой или массивом строк для разных языков

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"code":"missedCall","title":"Статус звонка","value":"Пропущен","type":"failure","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.activity.badge.add

Ответ

HTTP-статус: 200

{
    "result": {
        "badge": {
            "code": "missedCall",
            "title": "Статус звонка",
             "value": "Пропущен",
             "type": "failure"
        }
    },
    "time": {
        "start": 1724068028.331234,
        "finish": 1724068028.726591,
        "duration": 0.3953571319580078,
        "processing": 0.13033390045166016,
        "date_start": "2025-01-21T13:47:08+02:00",
        "date_finish": "2025-01-21T13:47:08+02:00",
        "operating": 0
    }
}

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

result object

Корневой элемент ответа, содержащий информацию о добавленном бейдже в случае успеха. В случае неудачи вернет null

time time

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

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

HTTP-статус: 400

{
    "error": "NOT_FOUND",
    "error_description": "Not found."
}
Код Описание Значение
ACCESS_DENIED Недостаточно прав для выполнения операции
REQUIRED_ARG_MISSING Не заполнены обязательные поля

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

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