users.getInfo — rest api

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

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

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

Параметры

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

Результат

Формат ответа для 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. ]

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

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

Коды ошибок

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

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

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