PastVu API

Устаревший адрес

API https://pastvu.com/api2 устарел. Пожалуйста, обновите ваши интеграции для использования нового адреса https://api.pastvu.com/api2.

кстати

Для получения фото, необходимо к URL добавить содержимое поля file из ответа API метода:

• https://img.pastvu.com/d/ для стандартного размера;
• https://img.pastvu.com/a/ для оригинального размера;
• https://img.pastvu.com/h/ для миниатюры.

Устаревшие адреса

• https://pastvu.com/_p/d/ для стандартного размера;
• https://pastvu.com/_p/a/ для оригинального размера;
• https://pastvu.com/_p/h/ для миниатюры.

Поддерживаются следующие методы:

photo.giveForPage

Возвращает данные для отображения страницы снимка по идентификатору cid.

Параметр	Обязательный	Тип	Описание
cid	✓	int	уникальный номер снимка

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

https://api.pastvu.com/api2?method=photo.giveForPage&params={"cid":2131190}

Сокращённый пример ответа:

{
  "result": {
    "photo": {
      "cid": 2131190,
      "file": "path/to/photo.jpg",
      "title": "Надвоицкий водопад",
      "y": "1925—1926",
      "year": 1925,
      "year2": 1926
    },
    "can": {},
    "forEdit": false
  },
  "rid": "..."
}

В примере приведены не все поля объекта photo. В зависимости от снимка и текущего пользователя объект также может содержать данные о местоположении, авторе и регионах.

Поле	Тип	Описание
result.photo.cid	int	идентификатор снимка
result.photo.type	int	тип объекта: 1 — фотография, 2 — картина
result.photo.file	string	относительный путь к файлу изображения; добавьте его к одному из адресов для получения изображения, указанных выше
result.photo.title	string	название снимка
result.photo.y	string	отображаемая датировка снимка
result.photo.year, result.photo.year2	int	первый и последний год датировки объекта
result.can	object	действия, доступные текущему пользователю
result.forEdit	bool	признак наличия в ответе данных для редактирования
rid	string	идентификатор запроса для диагностики

Ошибки:

Код	Когда возвращается
BAD_PARAMS	cid не указан, не является числом или меньше 1
NO_SUCH_PHOTO	снимок не существует или недоступен текущему пользователю

Ошибки API возвращаются в JSON с полем code на верхнем уровне и HTTP-статусом 200 OK. Проверяйте code в ответе, а не только HTTP-статус.

comment.giveForObj

Возвращает дерево комментариев по номеру фотографии.

Параметр	Обязательный	Тип	Описание
cid	✓	int	уникальный номер снимка

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

https://api.pastvu.com/api2?method=comment.giveForObj&params={"cid":23314}

photo.giveNearestPhotos

Возвращает массив фотографий, ближайших переданной координате. Массив отсортирован по возрастанию расстояния.

Параметр	Обязательный	Тип	По умолчанию	Описание
geo	✓	array [lat, lon]		координаты
except		int		исключить сid фото из выдачи
distance		int	10000	максимальное расстояние в метрах (<= 1000км)
year		int		нижняя граница года снимка
year2		int		верхняя граница года снимка
type		string	photo	photo или painting
limit		int	30	количество запрашиваемых фото (<= 30)
skip		int		пропустить указанное количество фото от начала результата поиска (для страничного вывода)

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

https://api.pastvu.com/api2?method=photo.giveNearestPhotos&params={"geo":[37.82,-122.469322],"limit":12,"except":228481}

photo.getByBounds

Возвращает фотографии и кластеры на карте по переданному зуму, GeoJSON объекту (Polygon или MultiPolygon) и опциональному ограничению по годам. Последовательность точек в массиве, формирующий полигон, должна следовать против часовой стрелки для выборки объектов внутри его границ (см. RFC7946 3.1.6). Порядок представления координат в точках - [lon, lat]. С 17 зума и более возвращаются только фотографии, до 16 включительно могут возвращаться как фото, так и кластеры.

Параметр	Обязательный	Тип	По умолчанию	Описание
geometry	✓	GeoJSON (Polygon или MultiPolygon)		область поиска
z	✓	int		значение зума
isPainting		bool	0	вернуть в ответе только картины
year		int		нижняя граница года снимка
year2		int		верхняя граница года снимка
localWork		bool	0	возвращать массив photos (следует установить 1 при значении зума >= 17)

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

https://api.pastvu.com/api2?method=photo.getByBounds&params={"z":11,"geometry":{"type":"Polygon","coordinates":[[[37.29034423828125,55.56902805913944],[37.95501708984375,55.56902805913944],[37.95501708984375,55.92150795277898],[37.29034423828125,55.92150795277898],[37.29034423828125,55.56902805913944]]]}}