photos.getAlbums rest api

Возврашает информацию об альбомах пользователя.

Параметры

Имя Тип Описание
aidsstringидентификаторы альбомов пользователя, о которых запрашивается информация

Результат

Формат ответа для json-выдачи (результат для xml аналогичен):

[
    {
        "aid": "_myphoto", // идентификатор альбома
        "cover_pid": 1, // идентификатор фотографии, служащей обложкой альбома
                        // пустое значение, если обложки нет
        "owner": "11425330190814458227", // идентификатор владельца
        "title": "Фото со мной",
        "description": "",
        "created": "1257364184", // время создания в формате unixtime
        "updated": "1257365345", // время последнего обновления в формате unixtime
        "size": 6, // количество фотографий в альбоме
        "privacy": 2, // уровень доступа к альбому, см. photos.createAlbumrest
        "link" : "http://foto.mail.ru/mail/natashka/_myphoto/"
    },
    ...
]

Коды ошибок

КодОписание
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.getAlbums&
app_id=423004&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=2c3858dfcc11168af2e362c17c7284fe

Пример ответа в формате JSON

[
    {
        "aid": "_myphoto",
        "cover_pid": 1,
        "owner": "11425330190814458227",
        "title": "Фото со мной",
        "description": "",
        "created": "1257364184",
        "updated": "1257365345",
        "size": 6,
        "privacy": 2,
        "link" : "http://foto.mail.ru/mail/natashka/_myphoto/"
    },
    {
        "aid": "something",
        "cover_pid": "",
        "owner": "11425330190814458227",
        "title": "Разные фотографии",
        "description": "Мои фотографии",
        "created": "1257364421",
        "updated": "1257369730",
        "size": 0,
        "privacy": 5,
        "link" : "http://foto.mail.ru/mail/natashka/something/"
    } 
]

Пример ответа в формате XML


    
        _myphoto
        1
        11425330190814458227
        Фото со мной
        
        1251749603
        1241431434
        6
        2
        http://foto.mail.ru/mail/natashka/_myphoto/
    
    
        something
        1
        11425330190814458227
        Разные фотографии
        
        1257364421
        1257369730
        0
        5
        http://foto.mail.ru/mail/natashka/something/
    

См. также

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

Функции REST API