photos.getAlbums rest api

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

Параметры

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

Результат

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

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

Коды ошибок

КодОписание
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

  1. [
  2.     {
  3.         "aid": "_myphoto",
  4.         "cover_pid": 1,
  5.         "owner": "11425330190814458227",
  6.         "title": "Фото со мной",
  7.         "description": "",
  8.         "created": "1257364184",
  9.         "updated": "1257365345",
  10.         "size": 6,
  11.         "privacy": 2,
  12.         "link" : "http://foto.mail.ru/mail/natashka/_myphoto/"
  13.     },
  14.     {
  15.         "aid": "something",
  16.         "cover_pid": "",
  17.         "owner": "11425330190814458227",
  18.         "title": "Разные фотографии",
  19.         "description": "Мои фотографии",
  20.         "created": "1257364421",
  21.         "updated": "1257369730",
  22.         "size": 0,
  23.         "privacy": 5,
  24.         "link" : "http://foto.mail.ru/mail/natashka/something/"
  25.     }
  26. ]

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

  1. <response_photos_getAlbums>
  2.     <album>
  3.         <aid>_myphoto</aid>
  4.         <cover_pid>1<cover_pid/>
  5.         <owner>11425330190814458227</owner>
  6.         <title>Фото со мной</title>
  7.         <description><description/>
  8.         <created>1251749603</created>
  9.         <updated>1241431434</updated>
  10.         <size>6</size>
  11.         <privacy>2</privacy>
  12.         <link>http://foto.mail.ru/mail/natashka/_myphoto/</link>
  13.     </album>
  14.     <album>
  15.         <aid>something</aid>
  16.         <cover_pid>1<cover_pid/>
  17.         <owner>11425330190814458227</owner>
  18.         <title>Разные фотографии</title>
  19.         <description><description/>
  20.         <created>1257364421</created>
  21.         <updated>1257369730</updated>
  22.         <size>0</size>
  23.         <privacy>5</privacy>
  24.         <link>http://foto.mail.ru/mail/natashka/something/</link>
  25.     </album>
  26. </response_photos_getAlbums>

См. также

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

Функции REST API