users.getInfo rest api

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

Функция возвращает только информацию, доступную текущему пользователю. Информация, которую текущий пользователь не может увидеть на странице запрашиваемых пользователей/групп не будет возвращена.

Чтобы получить идентификатор uid пользователя/группы по адресу личной страницы, используйте конвертор адресов страниц в uid.

Параметры

Имя Тип Описание
uidsstringсписок идентификаторов пользователей/групп, разделенных запятыми; не более 200 идентификаторов в одном вызове; если не задан, возвращается информация о текущем пользователе

1. Пример выдачи результата по пользователю:

Результат

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

  1. [
  2.   {
  3.     "uid": "15410773191172635989",
  4.     "first_name": "Евгений",
  5.     "last_name": "Маслов",
  6.     "nick": "maslov",
  7.     "email": "emaslov@mail.ru", // только в users.getInfo и только для внешних сайтов
  8.     "sex": 0, // 0 - мужчина, 1 - женщина
  9.     "birthday": "15.02.1980", // дата рождения в формате dd.mm.yyyy
  10.     "has_pic": 1, // есть ли аватар у пользователя (1 - есть, 0 - нет)
  11.     "pic": "http://avt.appsmail.ru/mail/emaslov/_avatar",
  12.     // уменьшенный аватар - размер по большей стороне не более 45px
  13.     "pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
  14.     // большой аватар - размер по большей стороне не более 600px
  15.     "pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
  16.     "link": "http://my.mail.ru/mail/emaslov/",
  17.     "referer_type": "", // тип реферера (см. ниже)
  18.     "referer_id": "", // идентификатор реферера (см. ниже)
  19.     "is_online": 1, // 1 - онлайн, 0 - не онлайн
  20.     "friends_count": 145, // количество друзей у пользователя
  21.     "is_verified": 1, //статус верификации пользователя (1 – телефон подтвержден, 0 – не подтвержден)
  22.     "vip" : 0, // 0 - не вип, 1 - вип
  23.     "app_installed": 1, // установлено ли у пользователя текущее приложение
  24.     "location": {
  25.       "country": {
  26.         "name": "Россия",
  27.         "id": "24"
  28.       },
  29.       "city": {
  30.         "name": "Москва",
  31.         "id": "25"
  32.       },
  33.       "region": {
  34.         "name": "Москва",
  35.         "id": "999999"
  36.       }
  37.     }
  38.   },
  39.   ...
  40. ]

2. Пример выдачи результата по группе:

Результат

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

  1. [
  2.   {
  3.     "pic_50":"http://avt.appsmail.ru/bk/pulimov/_cavatar50/17?/bk/pulimov/:17:1370601712",
  4.     "friends_count":29691,
  5.     "pic_22":"http://avt.appsmail.ru/bk/pulimov/_cavatar22/17?/bk/pulimov/:17:1370601712",
  6.     "nick":"Scienсе | Самое интересное и познавательное",
  7.     "is_verified":0,
  8.     "is_online":0,
  9.     "pic_big":"http://avt.appsmail.ru/bk/pulimov/_cavatarbig/17?/bk/pulimov/:17:1370601712",
  10.     "last_name":"",
  11.     "has_pic":0,
  12.     "pic_190":"http://avt.appsmail.ru/bk/pulimov/_cavatar190/17?/bk/pulimov/:17:1370601712",
  13.     "referer_id":"",
  14.     "vip":0,
  15.     "pic_32":"http://avt.appsmail.ru/bk/pulimov/_cavatar32/17?/bk/pulimov/:17:1370601712",
  16.     "subscribers_count":29195, // количество подписчиков
  17.     "birthday":"",
  18.     "referer_type":"",
  19.     "link":"http://my.mail.ru/community/nakedscience/","last_visit":null,
  20.     "uid":"13458246053116619814", // идентификатор группы
  21.     "app_installed":0,
  22.     "subscribe":0, // подписан ли текущий пользователь на эту группу
  23.     "status_text":"Интересные факты, психология, наука, ART и многое другое. Присоединяйтесь!",
  24.     "pic_128":"http://avt.appsmail.ru/bk/pulimov/_cavatar128/17?/bk/pulimov/:17:1370601712",
  25.     "group_info":{ // информация о группе
  26.       "short_description":"Интересные факты, психология, наука, ART и многое другое. Присоединяйтесь!",
  27.       "full_description":"Интересное из мира науки и не только!\nТо, что происходит вокруг нас каждый день!\nТо, что мы обязаны знать!\nТо, что мы обязаны передавать!\n\nЕжедневные рубрики:\n- Science-News (#Science);\n- Science-Date(#SciDate).\n- Познавательная статья из мира науки;\n\nНезависимые рубрики:\n- Science-Fact;\n- Science-Photo;\n- Science-Technology;\n- Science-Auto;\n- Science-Architecture;\n- Science-Design;\n- Science-Futurity;\n- Science-Psychology;\n- Science-Video;\n- Science-Health;\n- Science-Art;\n- Science-совет дня;\n- N самых;\n- Паранормальные и аномальные явления;\n- Science-Quotes;\n- Science-Other.\n\n2011-2013 Naked Science","interests":"наука, технологии, факты, психология, фотографии, природа, техника, авто, арт, искусство",
  28.       "posts_cnt":5,
  29.       "rules":"Уважаемые подписчики, следующие правила обязательны для всех, а за нарушение любого из пунктов, контакт будет добавлен в Черный список без предупреждения:\n\n1. Запрещен любой спам с призывами поставить сердечки, вступить в определенные сообщества или прочие действия попадающие под общепризнанное понятие \"спам\" (На всегда, без права на амнистию);\n2. Запрещено употреблять в комментариях любые, даже малозначимые матерные слова (На неделю);\n3. Строго запрещено участвовать в спорах на национальной почве, забивать \"стрелки\" и оскорблять друг друга (На всегда);\n4. Запрещена любая необоснованная критика в адрес администрации страницы или в адрес других участников (На неделю);\n5. Запрещено проявлять резкий негатив к статьям и выражать свое мнение в резко-отрицательной форме, у каждого свое мнение и порой лучше оставить свое мнение при себе и ничего не писать (На неделю).\n\nПримечание: все контакты, добавленные в Черный список, могут восстановить доступ к странице еще один раз через личное обращение к Администратору страницы, за исключением контактов добавленные в вышеупомянутый список по пункту 1.\n\nСпасибо, что Вы с нами!\nС уважением, администратор Science."
  30.     },
  31.     "sex":0,
  32.     "pic":"http://avt.appsmail.ru/bk/pulimov/_cavatar/17?/bk/pulimov/:17:1370601712",
  33.     "pic_small":"http://avt.appsmail.ru/bk/pulimov/_cavatarsmall/17?/bk/pulimov/:17:1370601712",
  34.     "pic_180":"http://avt.appsmail.ru/bk/pulimov/_cavatar180/17?/bk/pulimov/:17:1370601712",
  35.     "pic_40":"http://avt.appsmail.ru/bk/pulimov/_cavatar40/17?/bk/pulimov/:17:1370601712",
  36.     "first_name":""
  37.   }
  38. ]

Указанные поля могут отсутствовать, если они не указаны или не доступны для просмотра.

Если в запросе передано несколько uid, то результат выдается в виде массива.

Поля referer_type и referer_id указывают, откуда пришел пользователь, прежде чем установить ваше приложение. Подробную информацию читайте на странице Бонус за друга.

Коды ошибок

КодОписание
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=users.getInfo&
app_id=423004&session_key=be6ef89965d58e56dec21acb9b62bdaa&
sig=f82efdd230e45e58e4fa327fdf92135d&
uids=15410773191172635989,11425330190814458227

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

  1. [
  2.   {
  3.     "uid": "15410773191172635989",
  4.     "first_name": "Евгений",
  5.     "last_name": "Маслов",
  6.     "nick": "maslov",
  7.     "sex": 0,
  8.     "birthday": "15.02.1980",
  9.     "has_pic": 1,
  10.     "pic": "http://avt.appsmail.ru/mail/emaslov/_avatar",
  11.     "pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
  12.     "pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
  13.     "link": "http://my.mail.ru/mail/emaslov/",
  14.     "referer_type": "",
  15.     "referer_id": "",
  16.     "is_online": 1,
  17.     "is_verified": 1,
  18.     "friends_count": 145,
  19.     "vip" : 1,
  20.     "location": {
  21.       "country": {
  22.         "name": "Россия",
  23.         "id": "24"
  24.       },
  25.       "city": {
  26.         "name": "Москва",
  27.         "id": "25"
  28.       },
  29.       "region": {
  30.         "name": "Москва",
  31.         "id": "999999"
  32.       }
  33.     }
  34.   },
  35.   {
  36.     "uid": "11425330190814458227",
  37.     "first_name": "Наташа",
  38.     "last_name": "Ласточкина",
  39.     "nick": "lastochka",
  40.     "sex": 1,
  41.     "birthday": "21.10.1989",
  42.     "has_pic": 1,
  43.     "pic": "http://avt.appsmail.ru/mail/natashka/_avatar",
  44.     "pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
  45.     "pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
  46.     "link": "http://my.mail.ru/mail/natashka/",
  47.     "referer_type": "",
  48.     "referer_id": "",
  49.     "is_online": 0,
  50.     "friends_count": 203,
  51.     "vip" : 0,
  52.     "location": {
  53.       "country": {
  54.         "name": "Россия",
  55.         "id": "24"
  56.       },
  57.       "city": {
  58.         "name": "Жуковский",
  59.         "id": "1719"
  60.       },
  61.       "region": {
  62.         "name": "Московская обл.",
  63.         "id": "293"
  64.       }
  65.     }
  66.   }
  67. ]

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

  1. <response_users_getInfo>
  2.     <user>        
  3.         <uid>15410773191172635989</uid>
  4.         <first_name>Евгений</first_name>
  5.         <last_name>Маслов</last_name>
  6.         <nick>maslov</nick>
  7.         <sex>0</sex>
  8.         <birthday>30.01.1978</birthday>
  9.         <has_pic>1</has_pic>
  10.         <pic>http://avt.appsmail.ru/mail/emaslov/_avatar</pic>
  11.         <pic_big>http://avt.appsmail.ru/mail/emaslov/_avatarbig</pic_big>
  12.         <pic_small>http://avt.appsmail.ru/mail/emaslov/_avatarsmall</pic_small>        
  13.         <link>http://my.mail.ru/mail/emaslov/</link>
  14.         <referer_type></referer_type>
  15.         <referer_id></referer_id>
  16.         <is_online>1</is_online>
  17.         <friends_count>145</friends_count>
  18.         <vip>1</vip>
  19.         <location>
  20.             <city>
  21.                 <name>Москва</name>
  22.                 <id>25</id>
  23.             </city>
  24.             <country>
  25.                 <name>Россия</name>
  26.                 <id>24</id>
  27.             </country>
  28.             <region>
  29.                 <name>Москва</name>
  30.                 <id>999999</id>
  31.             </region>
  32.        </location>
  33.     </user>
  34.     <user>        
  35.         <uid>11425330190814458227</uid>
  36.         <first_name>Наташа</first_name>
  37.         <last_name>Ласточкина</last_name>
  38.         <nick>lastochka</nick>
  39.         <sex>1</sex>
  40.         <birthday>21.10.1989</birthday>
  41.         <has_pic>1</has_pic>
  42.         <pic>http://avt.appsmail.ru/mail/natashka/_avatar</pic>
  43.         <pic_big>http://avt.appsmail.ru/mail/natashka/_avatarbig</pic_big>
  44.         <pic_small>http://avt.appsmail.ru/mail/natashka/_avatarsmall</pic_small>        
  45.         <link>http://my.mail.ru/mail/natashka/</link>
  46.         <referer_type></referer_type>
  47.         <referer_id></referer_id>
  48.         <is_online>0</is_online>
  49.         <friends_count>203</friends_count>
  50.         <vip>0</vip>
  51.         <location>
  52.             <city>
  53.                 <name>Жуковский</name>
  54.                 <id>1719</id>
  55.             </city>
  56.             <country>
  57.                 <name>Россия</name>
  58.                 <id>24</id>
  59.             </country>
  60.             <region>
  61.                 <name>Московская обл.</name>
  62.                 <id>293</id>
  63.             </region>
  64.         </location>
  65.     </user>
  66. </response_users_getInfo>

См. также

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

Функции REST API