photos.createAlbum rest api

Создает новый фотоальбом.

Для вызова функции требуется привилегия photos. Вы можете создать фотоальбом без запроса привилегий с помощью функции photos.createAlbumjs.

Параметры

Имя Тип Описание
aidstringaid создаваемого альбома (будет частью url'а); обязательный параметр
titlestringназвание альбома; обязательный параметр
descriptionstringописание альбома
privacyintрежим доступа к альбому, описание возможных вариантов см. ниже; по-умолчанию 2
passwordstringпароль для доступа к альбому, указывается при значении privacy=3; кодировка UTF-8

Параметр aid задает желаемый aid альбома. Если альбом с таким aid уже есть, то новый альбом будет иметь случайный aid. Всегда проверяйте результат, возвращаемый функцией, для определения aid нового альбома.

Варианты уровней доступа для параметра privacy:

Обратите внимание, что из API доступны только альбомы, открытые для всех.

Результат

Возвращает объект созданного альбома в формате, аналогичном photos.getAlbumsrest.

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.

Пример вызова

http://www.appsmail.ru/platform/api?method=photos.createAlbum&
app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&aid=my_album&title=my%20album&
permissions=3&password=qwerty

См. также

Использование REST API

Функции REST API