photos.get — rest api

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

Параметры

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

Результат

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

[
  {
    "pid": 1, // идентификатор фотографии
    "aid": "_myphoto", 
    "owner": "11425330190814458227", 
    // путь к фотографии в стандартном размере (480px по большей стороне)
    "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg", 
    // путь к уменьшенной фотографии (120px по большей стороне)
    "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg",
    // путь к фотографии в полном размере 
    // (отсутствует, если фотография не превышает 480px)
    "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg",
    "created": 1241431501, // дата загрузки фотографии в альбом в формате unix time
    "width": 230, // ширина изображения в пикселах
    "height": 294, // высота изображения в пикселах
    "size": 42922, // размер фотографии в байтах
    "title": "Это я" 
  },
  ...
]

Коды ошибок

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

[
    {
        "pid": 1,
        "aid": "_myphoto",
        "owner": "11425330190814458227",
        "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg",
        "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg",
        "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg",
        "created": 1241431501,
        "width": 230,
        "height": 294,
        "size": 42922,
        "title": "Это я" 
    },
    {
        "pid": 3,
        "aid": "_myphoto",
        "owner": "11425330190814458227",
        "src": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-3.jpg",
        "src_small": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-3.jpg",
        "src_big": "http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-3.jpg",
        "created": 1250621243,
        "width": 360,
        "height": 480,
        "size": 61558,
        "title": "" 
    } 
]

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


  
    1
    _myphoto
    11425330190814458227
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-1.jpg
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-1.jpg
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-1.jpg
    1241431501
    230
    294
    42922
    Это я
  
  
    3
    _myphoto
    11425330190814458227
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/i-3.jpg
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/p-3.jpg
    http://content.foto.my.mail.ru/mail/natashka/_myphoto/s-3.jpg
    1250621243
    360
    480
    61558

См. также

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

Функции REST API