homepage.newsviews.list

Scope: homepage

Кто может вызывать: Авторизованный пользователь

Список записей просмотров из NewsViewsTable с фильтрацией и пагинацией.

HTTP: GET
Побочные эффекты: нет

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

Параметр Тип Обяз. Описание
filter object нет Mongo-фильтр по полям записи просмотра.
limit int нет Размер страницы (по умолчанию 50).
offset int нет Смещение (по умолчанию 0).
fetchAll bool нет Вернуть все страницы (с лимитом rest_fetch_all_max).

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

  • result - массив записей текущей страницы.
  • total - общее количество записей по фильтру.
  • next - смещение следующей страницы или null.
  • error - null при успехе.

Элемент списка:

  • id, userId, elementId, iblockId, views, dateFirstView, dateLastView

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
INVALID_LIMIT / LIMIT_EXCEEDED Некорректный limit
INVALID_OFFSET offset меньше 0
INVALID_FILTER / INVALID_FILTER_OPERATOR Некорректный filter
INTERNAL_ERROR Внутренняя ошибка сервиса

Примеры кода

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

curl -G "https://{portal}/rest/{user_id}/{webhook_code}/homepage.newsviews.list.json" \
          --data-urlencode "limit=10" \
          --data-urlencode "offset=0" \
          -H "Accept: application/json"

Пример ответа

{
          "result": {
            "result": [
              {
                "id": 77,
                "userId": 1,
                "elementId": 123,
                "iblockId": 43,
                "views": 6,
                "dateFirstView": "2026-06-16 10:00:00",
                "dateLastView": "2026-06-16 12:00:00"
              }
            ],
            "next": null,
            "error": null
          },
          "total": 1
        }

См. также

Предыдущая
Обзор раздела
Следующая
homepage.newsviews.get