users.getInfo rest api

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

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

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

Параметры

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

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

Результат

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

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

Результат

Формат ответа для 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 указывают, откуда пришел пользователь, прежде чем установить ваше приложение. Подробную информацию читайте на странице Бонус за друга.

Коды ошибок

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

[
  {
    "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
            
        
    

См. также

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

Функции REST API