Список пользовательских обзоров — метод GET (документация Steamworks)

Документация Steamworks

Список пользовательских обзоров — метод GET

Документация Steamworks > Облик в магазине > Список пользовательских обзоров — метод GET

Для получения списка обзоров о том или ином приложении в Steam воспользуйтесь следующими параметрами для описанного ниже метода.

Параметры:

GET store.steampowered.com/appreviews/<appid>?json=1

Название	Тип	Обязательно?	Описание
filter	string	✔	recent – сортировка по времени создания updated – сортировка по времени последнего обновления all – (по умолчанию) сортировка по полезности, со «скользящим окном» по параметру day_range, возвращаемые данные всегда будут найдены. Если вы просматриваете страницы списка обзоров с помощью `cursor`, вы можете выбрать либо recent, либо updated, чтобы рано или поздно получить в ответе пустой список.
language	string	✔	См. https://partner.steamgames.com/documentation/languages (используйте коды языков для API) или укажите all для того, чтобы получить все обзоры
day_range	string	✔	Интервал от текущего момента до n дней назад, в котором ищутся полезные отзывы. Применимо только для значения all параметра filter. Максимальное значение — 365.
cursor	string	✔	Обзоры возвращаются наборами по 20 штук, поэтому для первого набора передавайте значение «*», а для следующих наборов — возвращаемое значение параметра cursor. Обратите внимание: значения cursor могут содержать символы, которые нужно перекодировать в формат URL для параметров адресной строки.
review_type	string	✔	all – все обзоры (по умолчанию) positive – только положительные обзоры negative – только отрицательные обзоры
purchase_type	string	✔	all – все обзоры non_steam_purchase – обзоры пользователей, которые не платили за продукт в Steam steam – обзоры пользователей, которые заплатили за продукт в Steam (по умолчанию)
num_per_page	string	✔	По умолчанию будет возвращено до 20 обзоров. Этот параметр указывает, сколько обзоров необходимо вернуть (от 20 до 100).
filter_offtopic_activity	number		По умолчанию в этом API отсеиваются и не возвращаются обзоры не по теме (опубликованные в период «атаки обзорами»). Чтобы включить их, укажите значение «0». Больше информации здесь.

Возвращаемые значения

Метод возвращает список обзоров в формате JSON, которые соответствуют заданным параметрам, со следующими полями. Строки в JSON-файле могут содержать управляющие последовательности, и возвращённые данные может понадобиться раскодировать перед использованием.

Ответ:

success — 1, если запрос успешен
query_summary — возвращается в первом запросе
- num_reviews — число обзоров, возвращённых в этом ответе
- review_score — рейтинг игры по обзорам
- review_score_desc — описание рейтинга игры
- total_positive — число положительных обзоров
- total_negative — число отрицательных обзоров
- total_reviews — число обзоров, соответствующих параметрам запроса
cursor — значение параметра cursor, передаваемое в следующий запрос для получения следующего набора обзоров
reviews
- recommendationid — уникальный ID рекомендации
- author
  - steamid — SteamID пользователя
  - num_games_owned — число игр, которыми владеет пользователь
  - num_reviews — число обзоров, написанных пользователем
  - playtime_forever — время, проведённое в этом приложении за всё время
  - playtime_last_two_weeks — время, проведённое в этом приложении за две последние недели
  - playtime_forever — время, проведённое в приложении на момент написания обзора
  - last_played — время, когда пользователь запускал приложение в последний раз
- language — язык, указанный пользователем при написании обзора
- review — текст обзора
- timestamp_created — дата создания обзора в формате UNIX
- timestamp_updated — дата последнего изменения обзора в формате UNIX
- voted_up — значение true означает, что обзор положительный
- votes_up — число пользователей, посчитавших обзор полезным
- votes_funny — число пользователей, посчитавших обзор забавным
- weighted_vote_score — рейтинг полезности
- comment_count — число комментариев к этому обзору
- steam_purchase — true, если пользователь купил игру в Steam
- received_for_free — true, если пользователь поставил галочку, означающую, что он получил приложение бесплатно
- written_during_early_access — true, если обзор написан, когда игра была в раннем доступе
- developer_response — текст ответа разработчика, если он есть
- timestamp_dev_responded — время ответа разработчика в формате UNIX