Возвращает анкетную информацию о пользователях и/или группах.
Функция возвращает только информацию, доступную текущему пользователю. Информация, которую текущий пользователь не может увидеть на странице запрашиваемых пользователей/групп не будет возвращена.
Чтобы получить идентификатор uid пользователя/группы по адресу личной страницы, используйте конвертор адресов страниц в uid.
| Имя | Тип | Описание |
|---|---|---|
| uids | string | список идентификаторов пользователей/групп, разделенных запятыми; не более 200 идентификаторов в одном вызове; если не задан, возвращается информация о текущем пользователе |
Формат ответа для json-выдачи (результат для xml аналогичен):
[
{
"uid": "15410773191172635989",
"first_name": "Евгений",
"last_name": "Маслов",
"nick": "maslov",
"email": "emaslov@mail.ru", // только в users.getInfo и только для внешних сайтов
"sex": 0, // 0 - мужчина, 1 - женщина
"birthday": "15.02.1980", // дата рождения в формате dd.mm.yyyy
"has_pic": 1, // есть ли аватар у пользователя (1 - есть, 0 - нет)
"pic": "http://avt.appsmail.ru/mail/emaslov/_avatar",
// уменьшенный аватар - размер по большей стороне не более 45px
"pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
// большой аватар - размер по большей стороне не более 600px
"pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
"link": "http://my.mail.ru/mail/emaslov/",
"referer_type": "", // тип реферера (см. ниже)
"referer_id": "", // идентификатор реферера (см. ниже)
"is_online": 1, // 1 - онлайн, 0 - не онлайн
"friends_count": 145, // количество друзей у пользователя
"is_verified": 1, //статус верификации пользователя (1 – телефон подтвержден, 0 – не подтвержден)
"vip" : 0, // 0 - не вип, 1 - вип
"app_installed": 1, // установлено ли у пользователя текущее приложение
"location": {
"country": {
"name": "Россия",
"id": "24"
},
"city": {
"name": "Москва",
"id": "25"
},
"region": {
"name": "Москва",
"id": "999999"
}
}
},
...
]
Формат ответа для json-выдачи (результат для xml аналогичен):
[
{
"pic_50":"http://avt.appsmail.ru/bk/pulimov/_cavatar50/17?/bk/pulimov/:17:1370601712",
"friends_count":29691,
"pic_22":"http://avt.appsmail.ru/bk/pulimov/_cavatar22/17?/bk/pulimov/:17:1370601712",
"nick":"Scienсе | Самое интересное и познавательное",
"is_verified":0,
"is_online":0,
"pic_big":"http://avt.appsmail.ru/bk/pulimov/_cavatarbig/17?/bk/pulimov/:17:1370601712",
"last_name":"",
"has_pic":0,
"pic_190":"http://avt.appsmail.ru/bk/pulimov/_cavatar190/17?/bk/pulimov/:17:1370601712",
"referer_id":"",
"vip":0,
"pic_32":"http://avt.appsmail.ru/bk/pulimov/_cavatar32/17?/bk/pulimov/:17:1370601712",
"subscribers_count":29195, // количество подписчиков
"birthday":"",
"referer_type":"",
"link":"http://my.mail.ru/community/nakedscience/","last_visit":null,
"uid":"13458246053116619814", // идентификатор группы
"app_installed":0,
"subscribe":0, // подписан ли текущий пользователь на эту группу
"status_text":"Интересные факты, психология, наука, ART и многое другое. Присоединяйтесь!",
"pic_128":"http://avt.appsmail.ru/bk/pulimov/_cavatar128/17?/bk/pulimov/:17:1370601712",
"group_info":{ // информация о группе
"short_description":"Интересные факты, психология, наука, ART и многое другое. Присоединяйтесь!",
"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":"наука, технологии, факты, психология, фотографии, природа, техника, авто, арт, искусство",
"posts_cnt":5,
"rules":"Уважаемые подписчики, следующие правила обязательны для всех, а за нарушение любого из пунктов, контакт будет добавлен в Черный список без предупреждения:\n\n1. Запрещен любой спам с призывами поставить сердечки, вступить в определенные сообщества или прочие действия попадающие под общепризнанное понятие \"спам\" (На всегда, без права на амнистию);\n2. Запрещено употреблять в комментариях любые, даже малозначимые матерные слова (На неделю);\n3. Строго запрещено участвовать в спорах на национальной почве, забивать \"стрелки\" и оскорблять друг друга (На всегда);\n4. Запрещена любая необоснованная критика в адрес администрации страницы или в адрес других участников (На неделю);\n5. Запрещено проявлять резкий негатив к статьям и выражать свое мнение в резко-отрицательной форме, у каждого свое мнение и порой лучше оставить свое мнение при себе и ничего не писать (На неделю).\n\nПримечание: все контакты, добавленные в Черный список, могут восстановить доступ к странице еще один раз через личное обращение к Администратору страницы, за исключением контактов добавленные в вышеупомянутый список по пункту 1.\n\nСпасибо, что Вы с нами!\nС уважением, администратор Science."
},
"sex":0,
"pic":"http://avt.appsmail.ru/bk/pulimov/_cavatar/17?/bk/pulimov/:17:1370601712",
"pic_small":"http://avt.appsmail.ru/bk/pulimov/_cavatarsmall/17?/bk/pulimov/:17:1370601712",
"pic_180":"http://avt.appsmail.ru/bk/pulimov/_cavatar180/17?/bk/pulimov/:17:1370601712",
"pic_40":"http://avt.appsmail.ru/bk/pulimov/_cavatar40/17?/bk/pulimov/:17:1370601712",
"first_name":""
}
]
Указанные поля могут отсутствовать, если они не указаны или не доступны для просмотра.
Если в запросе передано несколько uid, то результат выдается в виде массива.
Поля referer_type и referer_id указывают, откуда пришел пользователь, прежде чем установить ваше приложение. Подробную информацию читайте на странице Бонус за друга.
| Код | Описание |
|---|---|
| 1 | Unknown error: Please resubmit the request. |
| 2 | Unknown method called. |
| 3 | Service Unavailable. Please try again later. |
| 4 | Method is deprecated. |
| 100 | One of the parameters specified is missing or invalid. |
| 102 | User authorization failed: the session key or uid is incorrect. |
| 103 | Application lookup failed: the application id is not correct. |
| 104 | Incorrect signature. |
| 105 | Application is not installed for this user. |
| 200 | Permission 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
[
{
"uid": "15410773191172635989",
"first_name": "Евгений",
"last_name": "Маслов",
"nick": "maslov",
"sex": 0,
"birthday": "15.02.1980",
"has_pic": 1,
"pic": "http://avt.appsmail.ru/mail/emaslov/_avatar",
"pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
"pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
"link": "http://my.mail.ru/mail/emaslov/",
"referer_type": "",
"referer_id": "",
"is_online": 1,
"is_verified": 1,
"friends_count": 145,
"vip" : 1,
"location": {
"country": {
"name": "Россия",
"id": "24"
},
"city": {
"name": "Москва",
"id": "25"
},
"region": {
"name": "Москва",
"id": "999999"
}
}
},
{
"uid": "11425330190814458227",
"first_name": "Наташа",
"last_name": "Ласточкина",
"nick": "lastochka",
"sex": 1,
"birthday": "21.10.1989",
"has_pic": 1,
"pic": "http://avt.appsmail.ru/mail/natashka/_avatar",
"pic_small": "http://avt.appsmail.ru/mail/emaslov/_avatarsmall",
"pic_big": "http://avt.appsmail.ru/mail/emaslov/_avatarbig",
"link": "http://my.mail.ru/mail/natashka/",
"referer_type": "",
"referer_id": "",
"is_online": 0,
"friends_count": 203,
"vip" : 0,
"location": {
"country": {
"name": "Россия",
"id": "24"
},
"city": {
"name": "Жуковский",
"id": "1719"
},
"region": {
"name": "Московская обл.",
"id": "293"
}
}
}
]
Пример ответа в формате XML
15410773191172635989
Евгений
Маслов
maslov
0
30.01.1978
1
http://avt.appsmail.ru/mail/emaslov/_avatar
http://avt.appsmail.ru/mail/emaslov/_avatarbig
http://avt.appsmail.ru/mail/emaslov/_avatarsmall
http://my.mail.ru/mail/emaslov/
1
145
1
Москва
25
Россия
24
Москва
999999
11425330190814458227
Наташа
Ласточкина
lastochka
1
21.10.1989
1
http://avt.appsmail.ru/mail/natashka/_avatar
http://avt.appsmail.ru/mail/natashka/_avatarbig
http://avt.appsmail.ru/mail/natashka/_avatarsmall
http://my.mail.ru/mail/natashka/
0
203
0
Жуковский
1719
Россия
24
Московская обл.
293