photos.get rest api

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

Параметры

Имя Тип Описание
aidstringидентификатор альбома, в котором хранится фотография; обязательный параметр
pidsstringидентификаторы фотографий, о которых запрашивается информация (разделяются запятой)

Результат

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

  1. [
  2.   {
  3.     "pid": 1, // идентификатор фотографии
  4.     "aid": "_myphoto",
  5.     "owner": "11425330190814458227",
  6.     // путь к фотографии в стандартном размере (480px по большей стороне)
  7.     "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg",
  8.     // путь к уменьшенной фотографии (120px по большей стороне)
  9.     "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg",
  10.     // путь к фотографии в полном размере
  11.     // (отсутствует, если фотография не превышает 480px)
  12.     "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg",
  13.     "created": 1241431501, // дата загрузки фотографии в альбом в формате unix time
  14.     "width": 230, // ширина изображения в пикселах
  15.     "height": 294, // высота изображения в пикселах
  16.     "size": 42922, // размер фотографии в байтах
  17.     "title": "Это я"
  18.   },
  19.   ...
  20. ]

Коды ошибок

КодОписание
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.get&app_id=423004&
session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=bba26c74957f72a75ab833bd5f0c1d83&aid=_myphoto

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

  1. [
  2.     {
  3.         "pid": 1,
  4.         "aid": "_myphoto",
  5.         "owner": "11425330190814458227",
  6.         "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg",
  7.         "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg",
  8.         "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg",
  9.         "created": 1241431501,
  10.         "width": 230,
  11.         "height": 294,
  12.         "size": 42922,
  13.         "title": "Это я"
  14.     },
  15.     {
  16.         "pid": 3,
  17.         "aid": "_myphoto",
  18.         "owner": "11425330190814458227",
  19.         "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-3.jpg",
  20.         "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-3.jpg",
  21.         "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-3.jpg",
  22.         "created": 1250621243,
  23.         "width": 360,
  24.         "height": 480,
  25.         "size": 61558,
  26.         "title": ""
  27.     }
  28. ]

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

  1. <response_photos_get>
  2.   <photo>
  3.     <pid>1</pid>
  4.     <aid>_myphoto</aid>
  5.     <owner>11425330190814458227</owner>
  6.     <src>http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg</src>
  7.     <src_small>http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg</src_small>
  8.     <src_big>http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg</src_big>
  9.     <created>1241431501</created>
  10.     <width>230</width>
  11.     <height>294</height>
  12.     <size>42922</size>
  13.     <title>Это я</title>
  14.   </photo>
  15.   <photo>
  16.     <pid>3</pid>
  17.     <aid>_myphoto</aid>
  18.     <owner>11425330190814458227</owner>
  19.     <src>http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-3.jpg</src>
  20.     <src_small>http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-3.jpg</src_small>
  21.     <src_big>http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-3.jpg</src_big>
  22.     <created>1250621243</created>
  23.     <width>360</width>
  24.     <height>480</height>
  25.     <size>61558</size>
  26.     <title></title>
  27.   </photo>
  28. </response_photos_get>

См. также

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

Функции REST API