VKWebAppGetUserInfo
VKWebAppGetUserInfo
получает данные о профиле пользователя, который запустил мини-приложение.
Пример
bridge.send('VKWebAppGetUserInfo', {
user_id: 743784474
})
.then((data) => {
if (data.id) {
// Данные пользователя получены
}
})
.catch((error) => {
// Ошибка
console.log(error);
});
Платформы
Android, iOS, Mobile Web, Web
Параметры
Поле | Тип | Описание |
---|---|---|
user_id
обязательное | integer | Идентификатор пользователя. |
Результат
Проверить результат можно:
- •
Используя объект
Promise
, который возвращается вызовомbridge.send(...)
. - •
С помощью событий
VKWebAppGetUserInfoResult
иVKWebAppGetUserFailed
.
Подробнее о проверке результатов при вызовах VK Bridge.
Объект Promise
Если обращение к платформе прошло успешно, управление будет передано в then
-обработчик объекта Promise
. В качестве ответа платформа возвращает объект со следующими полями:
Поле | Тип | Описание |
---|---|---|
id | integer | Идентификатор пользователя. |
bdate | string | Дата рождения пользователя. Например 10.4.1990 или 10.4 (если год рождения скрыт). Если дата рождения скрыта целиком, поле в ответе отсутствует. |
bdate_visibility | integer | Информация о том, отображается ли дата рождения пользователя. Возможные значения:
• 1 — дата рождения открыта целиком.
• 2 — открыты только день и месяц даты рождения.
• 0 — дата рождения скрыта. |
city | object | Информация о городе пользователя. Объект, который содержит поля:
• id (integer ) — идентификатор города.
• title (string ) — название города. |
country | object | Информация о стране пользователя. Объект, который содержит поля:
• id (integer ) — идентификатор страны.
• title (string ) — название страны. |
photo_200 | string | URL квадратной фотографии пользователя с шириной 200 пикселей. Если у пользователя отсутствует фотография, возвращается https://vk.com/images/camera_200.png . |
photo_max_orig | string | URL фотографии максимального размера. Может быть возвращена фотография, имеющая ширину как 400, так и 200 пикселей. Если у пользователя отсутствует фотография, возвращается https://vk.com/images/camera_400.png . |
sex | integer | Пол пользователя. Возможные значения:
• 1 — женский.
• 2 — мужской.
• 0 — пол не указан. |
photo_100 | string | URL квадратной фотографии пользователя с шириной 100 пикселей. Если у пользователя отсутствует фотография, возвращается https://vk.com/images/camera_100.png . |
first_name | string | Имя пользователя. |
last_name | string | Фамилия пользователя. |
can_access_closed | boolean | Информация о том, может ли пользователь, который открыл мини-приложение, видеть закрытый профиль пользователя. |
is_closed | boolean | Информация о том, закрыт ли профиль пользователя. |
Если при обращении к платформе произошла ошибка, управление передаётся в метод catch
. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.
События
VKWebAppGetUserInfoResult
Сигнализирует, что данные пользователя получены. В обработчик события на стороне пользователя передаются следующие данные:
{
detail: {
type: "VKWebAppGetUserInfoResult",
data: {
id: 743784474,
bdate: "21.12.2000",
bdate_visibility: 1,
city: {
id: 2,
title: "Санкт-Петербург"
},
country: {
id: 1,
title: "Россия"
},
photo_200: "https://sun1-91.userapi.com/s/v1/ig2/Dcf-SWu7nVYDDldq9oQegiC06VqsSa43-HpDxzPjrvFCUUk9nSevY2Uf9xzm0bxvLfgsTOH6XiiW-zeLcDhPDj_w.jpg?size=200x200&quality=96&crop=26,26,204,204&ava=1",
photo_max_orig: "https://sun1-91.userapi.com/s/v1/ig2/trHNebJQhG4BmLxC8h4hOpDU6bKRy6uJi586wcyFcCj5fzrwYk7AtoNab-RSil0Bp9b569VQyGK_skG9e6oK7Ap7.jpg?size=256x256&quality=96&crop=0,0,256,256&ava=1",
sex": 2,
photo_100: "https://sun1-91.userapi.com/s/v1/ig2/M4vtl7tcmeP6ANUgE0vU7JZWuJszbHaN5QcCcK2xD66EIc6SeSA1NyFVLTSOt2iLOkFhJSJ4DawEJGOjzKtszMpR.jpg?size=100x100&quality=96&crop=26,26,204,204&ava=1",
first_name: "Персик",
last_name: "Рыжий",
can_access_closed: true,
is_closed: false
}
}
}
Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.
VKWebAppGetUserInfoFailed
Информирует об ошибке, которая произошла при взаимодействии с платформой.
В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.
Пример обработки событий
Смотрите раздел Обработка событий-результатов.