audio.get — rest api

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

Позволяет получать информацию для любого пользователя Моего Мира при условии, что эта информация доступна владельцу сессии — то есть либо музыка должна быть публичной, либо открыта для друзей и пользователи должны быть друзьями. Иначе метод возвращает ошибку с кодом 202.

Обратите внимание, что если вы хотите получить музыку пользователя, не установившего ваше приложение, то в запросе вам обязательно надо передать валидный session_key.

Если вы хотите проиграть аудио-контент, вам необходимо передать к URL аудио записи session_key. Например:

Пример вызова

http://music.my.mail.ru/05091c0018001b0700190505070c120604135752010d.mp3?

session_key=551fd0e4779e35859dfccd03397dc8a0

Параметры

Имя Тип Описание
midsstringидентификаторы аудиозаписей, разделенные запятой; если не указано, возвращается информация обо всех аудиозаписях пользователя
uidstringидентификатор пользователя, для которого необходимо получить список аудиозаписей; по-умолчанию текущий пользователь

Результат

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

  1. [
  2.     {
  3.         "mid": "ca28a3cb2c6e6caca6453c6bb53478f2", // идентификатор аудиозаписи
  4.         "owner": "11425330190814458227",
  5.         "uploader": "11425330190814458227",
  6.         "artist": "A Camp",
  7.         "title": "I Can Buy You",
  8.         "duration": 229, // продолжительность аудиозаписи в секундах
  9.         "size": 5498548, // размер аудиозаписи в байтах
  10.         "created": 1257364184, // время загрузки аудиозаписи в формате unixtime
  11.         "link": "http://music.my.mail.ru/05091c0.mp3"
  12.     },
  13.     ...
  14. ]

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Method 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.
202Access to this object is denied

Пример вызова

http://www.appsmail.ru/platform/api?method=audio.get&app_id=423004&
session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=8730beefc28cb1e6d294aa3f9608efe4

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

  1. [
  2.     {
  3.         "mid": "ca28a3cb2c6e6caca6453c6bb53478f2",
  4.         "owner": "11425330190814458227",
  5.         "uploader": "11425330190814458227",
  6.         "artist": "A Camp",
  7.         "title": "I Can Buy You",
  8.         "duration": 229,
  9.         "size": 5498548,
  10.         "created": 1257364184,
  11.         "link": "http://music.my.mail.ru/05091c0018001b0700190505070c120604135752010d5804575501510f5c0450585356070d0c0b560e5b5001060c070c510b.mp3"
  12.     },
  13.     {
  14.         "mid": "72f7023789dbb5567b731b500f85aac5",
  15.         "owner": "11425330190814458227",
  16.         "uploader": "11425330190814458227",
  17.         "artist": "Feist",
  18.         "title": "I Feel It All",
  19.         "duration": 219,
  20.         "size": 5221679,
  21.         "created": 1257362203,
  22.         "link": "http://music.my.mail.ru/05091c0018001b0701190505070e1207001303015502090507000b0b5d5b50060c0600530e0a09570d0902520d0d5155540c.mp3"
  23.     }
  24. ]

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

  1. <response_audio_get>
  2.   <audio>
  3.     <artist>A Camp</artist>
  4.     <created>1252785507</created>
  5.     <duration>229</duration>
  6.     <link>http://music.my.mail.ru/05091c0018001b0700190505070c120604135752010d5804575501510f5c0450585356070d0c0b560e5b5001060c070c510b.mp3</link>
  7.     <mid>ca28a3cb2c6e6caca6453c6bb53478f2</mid>
  8.     <owner>11425330190814458227</owner>
  9.     <uploader>11425330190814458227</uploader>
  10.     <size>5498548</size>
  11.     <title>I Can Buy You</title>
  12.   </audio>
  13.   <audio>
  14.     <artist>Feist</artist>
  15.     <created>1252529260</created>
  16.     <duration>219</duration>
  17.     <link>http://music.my.mail.ru/05091c0018001b0701190505070e1207001303015502090507000b0b5d5b50060c0600530e0a09570d0902520d0d5155540c.mp3</link>
  18.     <mid>72f7023789dbb5567b731b500f85aac5</mid>
  19.     <owner>11425330190814458227</owner>
  20.     <uploader>11425330190814458227</uploader>
  21.     <size>5221676</size>
  22.     <title>I Feel It All</title>
  23.   </audio>
  24.   <audio>
  25.     <artist>Norah Jones</artist>
  26.     <created>1250191700</created>
  27.     <duration>307</duration>
  28.     <link>http://music.my.mail.ru/05091c0018001b0702190505070b1204071350000b57090e510357015f0f0b0b5c560305000d01565c08540c530c0906520e.mp3</link>
  29.     <mid>d38b09e4d3f698ef44949cd1f8f492e7</mid>
  30.     <owner>11425330190814458227</owner>
  31.     <uploader>11425330190814458227</uploader>
  32.     <size>12293268</size>
  33.     <title>New York City</title>
  34.   </audio>
  35. </response_audio_get>

См. также

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

Функции REST API