метод REST scope: main

main.eventlog.field.get

Получить поле журнала событий

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

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод main.eventlog.field.get возвращает описание поля записи журнала событий по имени.

Параметры

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

Имя поля, описание которого нужно получить

select array необязательный

Список полей описания, которые нужно вернуть в ответе.

Доступные поля:
- name — имя поля
- type — тип данных
- title — заголовок
- description — описание
- validationRules — правила валидации
- requiredGroups — группы обязательности
- filterable — признак доступности в фильтре
- sortable — признак доступности в сортировке
- editable — признак редактируемости
- multiple — признак множественного значения
- elementType — тип элемента для составных полей

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"name":"timestampX","select":["name","type","title","description","filterable","sortable","multiple"]}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/main.eventlog.field.get

Ответ

HTTP-статус: 200

{
    "result": {
        "item": {
            "name": "timestampX",
            "type": "object",
            "title": "DATE_CREATE",
            "description": "Дата и время события",
            "validationRules": [],
            "requiredGroups": null,
            "filterable": true,
            "sortable": true,
            "editable": false,
            "multiple": false,
            "elementType": null
        }
    },
    "time": {
        "start": 1769780771,
        "finish": 1769780771.081992,
        "duration": 0.08199191093444824,
        "processing": 0,
        "date_start": "2026-01-30T16:46:11+03:00",
        "date_finish": "2026-01-30T16:46:11+03:00",
        "operating_reset_at": 1769781371,
        "operating": 0
    }
}

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

result object

Объект с данными ответа

item object

Объект с описанием поля. Структура ответа зависит от select

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "field": "name",
                "message": "Обязательное поле `name` не указано"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
Доступ запрещен Нет прав администратора или не хватает scope main

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

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