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

Публикуйте объявления и сообщения в Живой ленте Битрикс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"]`	Получатели: `["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.id)
console.log('Получатели:', data.recipients)

Поля ответа:

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data.id`	number	Идентификатор созданного поста (URL поста — `https://<portal>.bitrix24.ru/company/personal/user/<authorId>/blog/<id>/`)
`data.recipients`	string[]	Применённый список получателей. Когда параметр `recipients` опущен или передан пустой массив, возвращается значение по умолчанию `["UA"]`

Пример ответа (201):

JSON

{
  "success": true,
  "data": {
    "id": 512,
    "recipients": ["UA"]
  }
}

URL поста в Битрикс24 строится из id и authorId:

https://<portal>.bitrix24.ru/company/personal/user/<authorId>/blog/<id>/

<authorId> — ID автора поста. При создании через POST /v1/posts автором становится сотрудник, токены которого настроены у API-ключа. Поле AUTHOR_ID возвращается в ответе `GET /v1/posts`. <portal> — домен портала. Доступ ограничен правами сотрудника в Битрикс24.