Метод getReviews

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

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

GET https://waste.fantastic-game.ru/opm/api/getReviews.php

Параметры запроса

type
string

Тип объекта карты. Возможные значения:

  • node – точка на карте
  • way – линия/полигон
  • relation – отношение
  • note – заметка (сообщение на карте)
  • changeset – правка на карте

id
integer

Числовой идентификатор объекта карты, отзывы (комментарии) о котором необходимо получить. Минимальное значение 1

author
integer

Числовой идентификатор пользователя, отзывы которого необходимо получить. Указывается вместо параметров type и id. Минимальное значение 0

offset
integer

Номер страницы. Минимальное значение 0

Ответ

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

Поля ответа

reviews
array

Массив объектов отзывов (комментариев)

reviews_count
integer

Общее количество отзывов (комментариев), соответствующих запросу. Возвращается в вслучае успеха

mark
float|null

Усредненная оценка.
Возвращает null если отсутствуют отзывы.

error
string

Возвращается в случае ошибки и содержит описание ошибки.

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