метод REST scope: log

log.blogpost.add

Добавить сообщение в Ленту новостей

Кто может выполнять: любой пользователь

Описание

Метод log.blogpost.add добавляет сообщение в Ленту новостей.

Параметры

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

Текст сообщения

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

Заголовок сообщения

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

Список адресатов, которые получат право на просмотр сообщения.

Возможные значения:

  • SG<X> — рабочие группы и проекты с идентификатором X. Идентификатор можно получить методом sonet_group.get
  • U<X> — пользователи с идентификатором X. Идентификатор можно получить методом user.get
  • UA — все авторизованные пользователи
  • DR<X> — подразделения компании с идентификатором X. Идентификатор можно получить методом department.get

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

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

Устаревший аналог DEST

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

Массив файлов в формате, описанном в работе с файлами.

Файлы будут загружены на Диск автора и привязаны к сообщению

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

Признак важного сообщения.

Возможные значения:

  • Y — сообщение важно
  • N — сообщение не важное

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

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

Дата и время в формате ISO 8601, до которого сообщение будет считаться важным

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

Идентификатор сайта.

По умолчанию — текущий сайт

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

Идентификатор пользователя, от имени которого публикуется сообщение. Доступно только администраторам.

Идентификатор можно получить с помощью метода user.get

По умолчанию — текущий пользователь, инициировавший вызов метода

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

Теги сообщения

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

Код фона сообщения

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

Автоматическое добавление превью ссылки из текста сообщения.

Возможные значения:
- Y — попытаться сформировать превью ссылки из POST_MESSAGE
- N — не формировать превью

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

UF_\ any обязательный

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

Пользовательские поля

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

Альтернатива FILES.

Передавайте список идентификаторов файлов Диска в формате ['n<ID_файла_диска>'].

Получить идентификатор можно с помощью методов disk.storage.getchildren и disk.folder.getchildren

При указании FILES параметр UF_BLOG_POST_FILE игнорируется

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

Признак важного сообщения.

Заполняется автоматически при IMPORTANT = 'Y'

UF_IMPRTANT_DATE_END datetime необязательный

Срок действия важного сообщения.

Заполняется автоматически при переданном IMPORTANT_DATE_END

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

Превью ссылки из текста сообщения.

Заполняется автоматически при PARSE_PREVIEW = 'Y', если превью удалось сформировать

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

Данные функционала Благодарность в формате:

 GRATITUDE_MEDAL: '<XML_ID_медали>',
 GRATITUDE_EMPLOYEES: [<ID_пользователя>]
UF_BLOG_POST_VOTE integer необязательный

Данные опроса в формате:

UF_BLOG_POST_VOTE: 'n<ID_опроса>',
'UF_BLOG_POST_VOTE_n<ID_опроса>_DATA': {
    QUESTIONS: [
        {
            QUESTION: 'Вопрос',
            FIELD_TYPE: 0, // Тип выбора: 0 — один вариант, 1 — несколько вариантов
            ANSWERS: [
                { MESSAGE: 'Ответ 1' },
                { MESSAGE: 'Ответ 2' }
            ]
        }
    ],
    ANONYMITY: 0, // Анонимность голосования: 0 — нет, 1 — да
    OPTIONS: 0 // Переголосование: 0 — запрещено, 1 — разрешено
}

При создании нового опроса используйте произвольный идентификатор с префиксом n

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"POST_TITLE":"Новый регламент","POST_MESSAGE":"С 1 ноября обновляется процесс согласования.","DEST":["UA"],"TAGS":"регламент,согласование,обновление","IMPORTANT":"Y","FILES":[["first-image.jpg","iVBORw0KGgoAAAANSUhEUgAAAAUA..."],["second-image.jpg","iVBORw0KGgoAAAANSUhEUgAAAAUA..."]]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/log.blogpost.add

Ответ

HTTP-статус: 200

{
    "result": 217,
    "time": {
        "start": 1773750554,
        "finish": 1773750555.955794,
        "duration": 1.955794095993042,
        "processing": 1,
        "date_start": "2026-03-17T15:29:14+03:00",
        "date_finish": "2026-03-17T15:29:15+03:00",
        "operating_reset_at": 1773751154,
        "operating": 0.9908020496368408
    }
}

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

result integer

Идентификатор созданного сообщения

time time

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

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

HTTP-статус: 400

{
    "error": "SONET_CONTROLLER_LIVEFEED_BLOGPOST_ADD_ERROR",
    "error_description": "Blog post hasn't been added"
}
Код Описание Значение
SONET_CONTROLLER_LIVEFEED_BLOGPOST_ADD_ERROR Blog post hasn't been added Общая ошибка сохранения сообщения, например, при пустом POST_MESSAGE
SONET_CONTROLLER_LIVEFEED_BLOGPOST_ADD_ERROR No destination specified Не удалось определить получателей сообщения
SONET_CONTROLLER_LIVEFEED_BLOGPOST_MODULE_BLOG_NOT_INSTALLED Blog module is not installed Модуль blog не установлен
SONET_CONTROLLER_LIVEFEED_BLOG_NOT_FOUND Blog not found Не удалось получить блог, к которому относится сообщение
Cannot add blog post Внутренняя ошибка при создании сообщения

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

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