#Лента активности

Публикуйте объявления и сообщения в Живой ленте Битрикс24 через API. Создавайте посты, делитесь с отделами и пользователями, комментируйте записи.

#Обзор

Feed API оборачивает Bitrix24 REST API (log.blogpost.*, log.blogcomment.*) в 7 RESTful-эндпоинтов. Позволяет публиковать объявления в общей ленте портала, адресовать конкретным отделам или пользователям, расшаривать посты и добавлять комментарии.

Требуемый скоуп: log

Базовый URL: https://vibecode.bitrix24.tech/v1

Авторизация: заголовок X-Api-Key с вашим API-ключом.


#Быстрый старт

#1. Опубликуйте объявление всем

Terminal
curl -X POST https://vibecode.bitrix24.tech/v1/posts \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Обновление API",
    "text": "Вышла новая версия API с поддержкой батч-запросов!",
    "recipients": ["UA"]
  }'

Ответ:

JSON
{
  "success": true,
  "data": 512
}

#2. Прокомментируйте пост

Terminal
curl -X POST https://vibecode.bitrix24.tech/v1/posts/512/comments \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Отличная новость! Когда документация обновится?" }'

#3. Расшарьте пост дополнительным получателям

Terminal
curl -X POST https://vibecode.bitrix24.tech/v1/posts/512/share \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "recipients": ["DR3", "U5"] }'

#Посты

#POST /v1/posts

Создаёт новый пост в Живой ленте Битрикс24. Bitrix24: log.blogpost.add

Параметры:

Параметр В Тип Обяз. По умолч. Описание
text body string да Текст поста (поддерживает BB-код). Передаётся как POST_MESSAGE
title body string нет Заголовок поста. Передаётся как POST_TITLE
recipients body string[] нет Получатели: ["UA"] — все, ["U1"] — пользователь, ["DR1"] — отдел рекурсивно, ["D1"] — отдел, ["SG5"] — группа. Передаётся как DEST
files body array нет Массив файлов. Передаётся как FILES

Пример (curl):

Terminal
curl -X POST https://vibecode.bitrix24.tech/v1/posts \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Результаты квартала",
    "text": "[b]Итоги Q1 2026:[/b]\n\n- Выручка: 15.2 млн руб. (+23%)\n- Новых клиентов: 48\n- NPS: 72\n\nСпасибо команде за отличную работу!",
    "recipients": ["UA"]
  }'

Пример (JavaScript):

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/posts', {
  method: 'POST',
  headers: {
    'X-Api-Key': VIBE_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Результаты квартала',
    text: [
      '[b]Итоги Q1 2026:[/b]',
      '',
      '- Выручка: 15.2 млн руб. (+23%)',
      '- Новых клиентов: 48',
      '- NPS: 72',
      '',
      'Спасибо команде за отличную работу!'
    ].join('\n'),
    recipients: ['UA']
  })
})

const { data } = await res.json()
console.log('Post ID:', data)

Ответ (201):

JSON
{
  "success": true,
  "data": 512
}