Создает новый фотоальбом.
Для вызова функции требуется привилегия photos. Вы можете создать фотоальбом без запроса привилегий с помощью функции photos.createAlbumjs.
Имя | Тип | Описание |
---|---|---|
aid | string | aid создаваемого альбома (будет частью url'а); обязательный параметр |
title | string | название альбома; обязательный параметр |
description | string | описание альбома |
privacy | int | режим доступа к альбому, описание возможных вариантов см. ниже; по-умолчанию 2 |
password | string | пароль для доступа к альбому, указывается при значении privacy=3; кодировка UTF-8 |
Параметр aid задает желаемый aid альбома. Если альбом с таким aid уже есть, то новый альбом будет иметь случайный aid. Всегда проверяйте результат, возвращаемый функцией, для определения aid нового альбома.
Варианты уровней доступа для параметра privacy:
Обратите внимание, что из API доступны только альбомы, открытые для всех.
Возвращает объект созданного альбома в формате, аналогичном photos.getAlbumsrest.
Код | Описание |
---|---|
1 | Unknown error: Please resubmit the request. |
2 | Unknown method called. |
3 | Service Unavailable. Please try again later. |
4 | Method is deprecated. |
100 | One of the parameters specified is missing or invalid. |
102 | User authorization failed: the session key or uid is incorrect. |
103 | Application lookup failed: the application id is not correct. |
104 | Incorrect signature. |
105 | Application is not installed for this user. |
200 | Permission 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