← Назад к API

Фото

Методы для работы с фотографиями, альбомами и загрузкой изображений

GET photos.getUploadServer

Получение адреса сервера для загрузки фото в альбом.

Параметры:

album_id — ID альбома (опционально)

group_id — ID группы (для загрузки в группу)

Пример:

GET /method/photos.getUploadServer.json?album_id=123

Ответ:

{
  "upload_url": "https://vsetke.fun/upload/photo/...",
  "album_id": 123,
  "user_id": 456
}

POST photos.save

Сохранение загруженных фотографий.

Параметры:

album_id — ID альбома

photos_list * — JSON строка с информацией о загруженных фото

hash * — Хэш для проверки

caption — Подпись к фото

Пример:

POST /method/photos.save.json
photos_list=["hash":"abc123","resource":"photo.jpg"]&hash=def456

Ответ:

[{
  "id": 123456,
  "album_id": 789,
  "owner_id": 1,
  "sizes": [
    {"type": "s", "url": "...", "width": 75, "height": 75},
    {"type": "m", "url": "...", "width": 130, "height": 130},
    {"type": "x", "url": "...", "width": 604, "height": 604}
  ]
}]

GET photos.get

Получение фотографий из альбома.

Параметры:

owner_id * — ID владельца альбома

album_id * — ID альбома

photo_ids — ID конкретных фото через запятую

offset — Смещение (по умолчанию 0)

count — Количество фото (макс. 1000)

photo_sizes — Возвращать размеры фото

Пример:

GET /method/photos.get.json?owner_id=1&album_id=wall&count=20

Ответ:

{
  "count": 150,
  "items": [{
    "id": 123456,
    "album_id": 789,
    "owner_id": 1,
    "sizes": [...],
    "text": "Подпись к фото",
    "date": 1609459200
  }]
}

GET photos.getAlbums

Получение списка альбомов пользователя или группы.

Параметры:

owner_id — ID владельца альбомов

album_ids — ID конкретных альбомов через запятую

offset — Смещение

count — Количество альбомов (макс. 100)

need_covers — Возвращать обложки альбомов

Пример:

GET /method/photos.getAlbums.json?owner_id=1&need_covers=1

Ответ:

{
  "count": 5,
  "items": [{
    "id": 123,
    "thumb_id": 456789,
    "owner_id": 1,
    "title": "Мои фото",
    "description": "Личные фотографии",
    "created": 1609459200,
    "updated": 1609459200,
    "size": 25,
    "can_upload": 1
  }]
}

POST photos.createAlbum

Создание нового альбома для фото.

Параметры:

title * — Название альбома

group_id — ID группы (для создания альбома группы)

description — Описание альбома

Пример:

POST /method/photos.createAlbum.json?title=Мои фото&description=Личные фотографии

Ответ:

{
  "id": 123,
  "thumb_id": null,
  "owner_id": 1,
  "title": "Мои фото",
  "description": "Личные фотографии",
  "created": 1609459200,
  "updated": 1609459200,
  "size": 0,
  "can_upload": 1
}

POST photos.delete

Удаление фотографии.

Параметры:

owner_id — ID владельца фото (по умолчанию текущий пользователь)

photo_id — ID фото для удаления

photos — Список фото в формате owner_id_photo_id через запятую

Пример:

POST /method/photos.delete.json?photo_id=123456

📤 Процесс загрузки фото

1. Получить upload_url через photos.getUploadServer

2. Загрузить фото на полученный URL методом POST

3. Сохранить фото через photos.save с полученными параметрами