ipr.course.review.list

Scope: ipr

Кто может вызывать: Любой авторизованный пользователь. Подробнее: Модель доступа

Возвращает отзывы о курсе (текст и оценка 1..5). Новые отзывы идут первыми.

HTTP: GET

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

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

Параметр Тип Обяз. Описание
courseId int да ID курса (допустимо также в filter.courseId)
userId int нет Только отзыв этого пользователя (допустимо также в filter.userId)
limit int нет Размер страницы, по умолчанию 50, максимум 500
offset int нет Смещение
fetchAll bool нет Вернуть все записи одним ответом (максимум 5000)

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

Массив result и total. Элемент:

Поле Тип Описание
id int ID сообщения форума с отзывом
courseId int ID курса
userId int Автор отзыва
authorName string Имя автора
text string|null Текст отзыва без служебной цитаты [QUOTE]
date string|null Дата отзыва, YYYY-MM-DD HH:MM:SS
rating int|null Оценка автора 1..5

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

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR courseId не передан
NOT_FOUND Курс не найден
INVALID_LIMIT / LIMIT_EXCEEDED / INVALID_OFFSET Некорректные параметры пагинации
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (GET)

curl -G "https://{портал}/rest/{user_id}/{webhook_code}/ipr.course.review.list.json"
          -H "Accept: application/json"
          --data-urlencode "courseId=305"

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

{
          "result": {
            "result": [
              {
                "id": 88001,
                "courseId": 305,
                "userId": 15,
                "authorName": "Иван Петров",
                "text": "Полезный курс, много практики",
                "date": "2026-10-10 14:30:00",
                "rating": 5
              }
            ],
            "total": 1,
            "next": null,
            "error": null
          }
        }

См. также

Предыдущая
ipr.course.delete
Следующая
ipr.course.review.add