Получить комментарии пользователя log.blogcomment.user.get

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: log

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

Метод log.blogcomment.user.get возвращает комментарии пользователя к сообщениям Ленты новостей и сведения о прикрепленных к ним файлах.

Параметры метода

Обязательные параметры отмечены *

Название `тип`	Описание
USER_ID `integer`	Идентификатор пользователя, чьи комментарии нужно получить. Если параметр не передан или его передает не администратор, вернутся комментарии текущего пользователя. Комментарии другого пользователя может получить только администратор. Поле `text` в них пустое, кроме служебных комментариев: у них приходит служебный текст. Идентификатор пользователя можно получить с помощью метода user.get или user.search
FIRST_ID `integer`	Метод вернет комментарии, у которых `id` больше этого значения. Не передавайте сюда `comment_id`: это другой идентификатор
LAST_ID `integer`	Метод вернет комментарии, у которых `id` меньше этого значения. Если передан и `FIRST_ID`, метод учтет только `FIRST_ID`
LIMIT `integer`	Сколько комментариев вернуть, от `1` до `1000`. По умолчанию `100`. Большее значение метод заменит на `1000`

Примеры кода

Как использовать примеры в документации

cURL (Webhook)

cURL (OAuth)

JS (TS)

JS (UMD)

Python

PHP

BX24.js

PHP CRest

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"USER_ID":28,"FIRST_ID":215}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/log.blogcomment.user.get

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"USER_ID":28,"FIRST_ID":215,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/log.blogcomment.user.get

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

// Shape of the payload returned in result (match the "response handling" section of the page)
type BlogCommentUserGetResult = {
  COMMENTS: {
    id: number
    comment_id: number
    post_id: number
    date: ISODate
    text: string
    attach: number[]
  }[]
  // An empty array is returned when no files are attached
  FILES: [] | Record<string, {
    id: number
    date: ISODate
    type: string
    name: string
    size: number
    // Image or video preview size; false for other files
    image: {
      width: number
      height: number
    } | false
    authorId: number
    authorName: string
    urlPreview: string | null
    urlShow: string
    urlDownload: string
  }>
}

try {
  const response = await $b24.actions.v2.call.make<BlogCommentUserGetResult>({
    method: 'log.blogcomment.user.get',
    params: {
      USER_ID: 28,
      FIRST_ID: 215,
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Comments:', result.COMMENTS, 'Files:', result.FILES)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function getBlogCommentsForUser() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'log.blogcomment.user.get',
        params: {
          USER_ID: 28,
          FIRST_ID: 215,
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Comments:', result.COMMENTS, 'Files:', result.FILES)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', getBlogCommentsForUser)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.log.blogcomment.user.get(
        user_id=28,
        first_id=215,
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")

try {
    $response = $b24Service
        ->core
        ->call(
            'log.blogcomment.user.get',
            [
                'USER_ID' => 28,
                'FIRST_ID' => 215,
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    print_r($result);
} catch (Throwable $exception) {
    echo $exception->getMessage();
}

BX24.callMethod('log.blogcomment.user.get', {
    USER_ID: 28,
    FIRST_ID: 215
},
function(result) {
        if (result.error()) {
            console.error(result.error());
        } else {
            console.info(result.data());
        }
    }
);

require_once('crest.php');

$result = CRest::call(
    'log.blogcomment.user.get',
    [
        'USER_ID'  => 28,
        'FIRST_ID' => 215,
    ]
);

if (array_key_exists('error', $result)) {
    echo 'Error: ' . $result['error_description'];
} else {
    echo 'Comments: ' . print_r($result['result'], true);
}

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "log.blogcomment.user.get", b24.Params{
	"USER_ID":  28,
	"FIRST_ID": 215,
}, b24.WithIdempotent())
if err != nil {
	return fmt.Errorf("log.blogcomment.user.get: %w", err)
}

// Форма ответа показана ниже на этой странице.
fmt.Printf("%s\n", res.Result)

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "COMMENTS": [
            {
                "id": 4821,
                "comment_id": 4821,
                "post_id": 13579,
                "date": "2024-10-14T11:05:42+03:00",
                "text": "Поддерживаю идею!",
                "attach": [
                    90210
                ]
            }
        ],
        "FILES": {
            "90210": {
                "id": 90210,
                "date": "2024-10-14T11:02:18+03:00",
                "type": "image",
                "name": "diagram.png",
                "size": 184320,
                "image": {
                    "width": 1280,
                    "height": 720
                },
                "authorId": 28,
                "authorName": "Иван Иванов",
                "urlPreview": "https://example.bitrix24.ru/disk/showPreview/90210",
                "urlShow": "https://example.bitrix24.ru/disk/showFile/90210",
                "urlDownload": "https://example.bitrix24.ru/disk/downloadFile/90210"
            }
        }
    },
    "time": {
        "start": 1728905100.112233,
        "finish": 1728905100.498321,
        "duration": 0.38608813285827637,
        "processing": 0.14598798751831055,
        "date_start": "2024-10-14T14:25:00+03:00",
        "date_finish": "2024-10-14T14:25:00+03:00",
        "operating": 0
    }
}

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

Название `тип`	Описание
result `object`	Корневой объект ответа. Содержит массив комментариев и информацию о прикрепленных файлах (подробное описание)
time `time`	Информация о времени выполнения запроса

Объект result

Название
тип

Описание

COMMENTS
object[]

Массив комментариев пользователя, от новых к старым: по убыванию comment_id. Структура элемента описана ниже

FILES
object | array

Файлы, прикрепленные к комментариям, в формате {"<идентификатор файла>": {…}}. Ключ — идентификатор файла на Диске из массива attach комментария. Структура файла описана ниже.

Если файлов нет, возвращается пустой массив []

Элемент массива COMMENTS

Название `тип`	Описание
id `integer`	Идентификатор записи о комментарии в Ленте новостей. Его передают в `FIRST_ID` и `LAST_ID`
comment_id `integer`	Идентификатор самого комментария. Передайте его в метод log.blogcomment.delete
post_id `integer`	Идентификатор сообщения Ленты новостей, к которому оставлен комментарий
date `datetime`	Дата и время создания комментария в формате ISO 8601
text `string`	Текст комментария. Если администратор запрашивает комментарии другого пользователя, текст пустой, кроме служебных комментариев
attach `integer[]`	Идентификаторы файлов Диска, прикрепленных к комментарию. Описание файлов — в объекте `FILES`

Объект файла в FILES

Название `тип`	Описание
id `integer`	Идентификатор файла на Диске
date `datetime`	Дата и время загрузки файла в формате ISO 8601
type `string`	Тип файла: `image` — изображение, `video` — видео, `file` — другой файл
name `string`	Имя файла
size `integer`	Размер файла в байтах
image `object` \| `boolean`	Размеры изображения или превью видео: `width` и `height` — ширина и высота в пикселях, целые числа. Для других файлов — `false`
authorId `integer`	Идентификатор пользователя, который загрузил файл
authorName `string`	Имя пользователя, который загрузил файл
urlPreview `string` \| `null`	Ссылка на превью файла. Если превью нет, возвращается `null`
urlShow `string`	Ссылка для просмотра изображения. Для других файлов совпадает со ссылкой на скачивание
urlDownload `string`	Ссылка для скачивания файла

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

Название `тип`	Описание
error `string`	Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только `error_description`
error_description `string`	Текст ошибки для разработчика. Не показывайте его конечному пользователю без обработки

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит
`401`	`NO_AUTH_FOUND` Wrong authorization data	В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука
`401`	`INVALID_REQUEST` Https required	Методы вызываются только по протоколу HTTPS
`401`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24
`401`	`ACCESS_DENIED` REST is available only on commercial plans	REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — `REST is available only by subscription`
`401`	`INVALID_CREDENTIALS` Invalid request credentials	Не найден активный вебхук с указанным идентификатором пользователя и секретным кодом
`404`	`ERROR_METHOD_NOT_FOUND` Method not found!	Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа
`401`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на `provided by the access token`
`401`	`expired_token` The access token provided has expired	Срок действия access-токена истек
`401`	`user_access_error` The user does not have access to the application	Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям
`403`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Была ли статья полезна?

Получить комментарии к сообщению

Удалить комментарий

Получить комментарии пользователя log.blogcomment.user.get

Параметры методаПараметры метода

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

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

Объект resultОбъект result

Элемент массива COMMENTSЭлемент массива COMMENTS

Объект файла в FILESОбъект файла в FILES

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

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение