photos

photos.getAll

Возвращает все фотографии пользователя или сообщества в антихронологическом порядке.

Для вызова метода можно использовать:
• ключ доступа пользователя (требуется право доступа: photos — выдаётся в исключительных случаях через запрос в поддержку по электронной почте [email protected])

Параметры

owner_id

integer

Идентификатор пользователя или сообщества, фотографии которого нужно получить.

Обратите внимание, идентификатор сообщества в параметре owner_id необходимо указывать со знаком «-» — например, owner_id=-1 соответствует идентификатору сообщества ВКонтакте API (club1).

extended

checkbox

1 — возвращать расширенную информацию о фотографиях.

offset

positive

Смещение, необходимое для выборки определенного подмножества фотографий. По умолчанию — 0.

count

positive

Число фотографий, информацию о которых необходимо получить.

photo_sizes

checkbox

1 — будут возвращены размеры фотографий в специальном формате.

no_service_albums

checkbox

0 — вернуть все фотографии, включая находящиеся в сервисных альбомах, таких как «Фотографии на моей стене» (по умолчанию); 1 — вернуть фотографии только из стандартных альбомов пользователя или сообщества.

need_hidden

checkbox

1 — возвращает информацию от том, скрыта ли фотография из блока над стеной пользователя.

skip_hidden

checkbox

1 — не возвращать фотографии, скрытые из блока над стеной пользователя (параметр учитывается только при owner_id > 0, параметр no_service_albums игнорируется).

Результат

После успешного выполнения возвращает список объектов photo.

Если был задан параметр extended=1, возвращаются дополнительные поля:

  • •
    likes — количество отметок «Мне нравится» и информация о том, поставил ли лайк текущий пользователь;
  • •
    reposts — число репостов фотографии.

Если был задан параметр photo_sizes=1, вместо полей width и height возвращаются размеры копий фотографии в специальном формате.

Если был задан параметр need_hidden=1, будет возвращено поле hidden = 1 в случае, если фотография скрыта из блока над стеной пользователя.

Если был задан параметр skip_hidden=1, для объекта ответа будет возвращено поле more, принимающее значения 1 или 0, обозначающее наличие или отсутствие следующих страниц с фотографиями пользователя. Также для объекта фотографии будет возвращено поле real_offset, обозначающее настоящую позицию фотографии из всех фотографий пользователя. Максимальное полученное значение этого поля необходимо передать в offset запроса для следующей страницы.

Коды ошибок

19
Content blocked

В ходе выполнения могут произойти общие ошибки

Связанные версии

Перейти на страницу версий API
5.77

Добавлен новый формат объекта photo.