Метод getReviews

Метод позволяет получить список отзывов (или комментариев), оставленных к определенному объекту карты либо оставленных конкретным пользователем. Метод является частью публичного API и его можно вызывать без указания токена доступа. Метод можно вызвать как GET-запросом, так и POST-запросом. За один запрос можно получить только 10 отзывов (комментариев).

GET https://waste.fantastic-game.ru/opm/api/getReviews.php?<PARAMS>

Отзывы и комментарии, по сути, являются синонимами. Единственное, что отличает отзыв от комментария – это наличие оценки: к основным объектам карты (node, way и relation) каждый пользователь может оставить только один отзыв с указанием оценки по пятибалльной шкале, а к дополнительным объектам карты (node и changeset) пользователь может оставлять неограниченное количество комментариев, не имеющих оценки.

Параметры

Параметр Описание
type
строка		 Тип объекта карты:
node – одиночная точка на карте
way – линия (полигон)
relation – отношение (например, автобусный маршрут)
note – публичное сообщение на карте (заметка)
changeset – пакет правок
id
число		 Числовой идентификатор объекта карты, отзывы (комментарии) о котором необходимо получить
author
число		 Числовой идентификатор пользователя, отзывы которого необходимо получить. Указывается вместо параметров type и id.
offset
число
Обязательный		 Номер страницы. 0 — первая страница, 1 — вторая…
.

Ответ

В случае успеха в ответе придет общее количество отзывов reviews_count, усредненная оценка (при наличии отзывов) mark и массив с 10-ю объектами отзывов.

Поля ответа

Поле Описание
reviews
массив		 Массив с объектами отзывов (комментариев).
reviews_count
число		 Общее количество отзывов.
Примечание: поле содержит общее число отзывов, а не количество возвращаемых в reviews отзывов
mark
float|null		 Усредненная оценка.
Возвращает null если отсутствуют отзывы.
error
строка		 Возвращается в случае ошибки. Содержит описание ошибки

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

Просмотры: 131
Pages: 1 2