knowledgebase.comment.getCount
Scope:
knowledgebaseКто может вызывать:
IblockRights::elementUserHasRightTo(..., 'element_read')на статью. Подробнее: Права доступа
Количество комментариев к статье (всего и новых для текущего пользователя)
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
articleId |
int |
да | ID статьи |
Возвращаемые данные
Ответ в конверте модуля: result.result — { total, new }; result.error.
| Поле | Описание |
|---|---|
total |
Общее количество комментариев |
new |
Количество новых комментариев для текущего пользователя |
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Некорректные или неполные параметры (articleId) |
PERMISSION_DENIED |
Нет прав на чтение статьи |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/knowledgebase.comment.getCount.json" \
-H "Accept: application/json" \
--data-urlencode "articleId=501"
Пример ответа
{
"result": {
"result": {
"total": 0,
"new": 0
},
"error": null
}
}
См. также
Предыдущая
Следующая