ДокументацияAPIСообществоСоздать приложение
Войти

VKWebAppGetGroupInfo

VKWebAppGetGroupInfo получает информацию о сообществе.

Пример

JavaScriptbridge.send('VKWebAppGetGroupInfo', { group_id: 166562603 }) .then((data) => { if (data.id) { // Данные о сообществе получены } }) .catch((error) => { // Ошибка console.log(error); });

Платформы

Android, iOS, Mobile Web, Web

Параметры

ПолеТипОписание
group_id обязательноеintegerИдентификатор сообщества.

Результат

Проверить результат можно:

  • •

    Используя объект Promise, который возвращается вызовом bridge.send(...).

  • •

    С помощью событий VKWebAppGetGroupInfoResult и VKWebAppGetGroupInfoFailed.

Подробнее о проверке результатов при вызовах VK Bridge.

Возможные ошибки:

  • •
    This action cannot be performed in the background, если мини-приложение запущено в фоновом режиме.

Объект Promise

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующим полем:

ПолеТипОписание
idintegerИдентификатор сообщества.
namestringНазвание сообщества.
screen_namestringКороткий адрес.
is_closedintegerИнформация о том, является ли сообщество закрытым. Возможные значения:    • 0 — открытое.    • 1 — закрытое.    • 2 — частное.
descriptionstringОписание сообщества.
members_countintegerКоличество участников сообщества.
photo_50stringURL квадратной фотографии сообщества с шириной 50 пикселей. Если у сообщества отсутствует фотография, возвращается https://vk.com/images/community_50.png.
photo_100stringURL квадратной фотографии сообщества с шириной 100 пикселей. Если у сообщества отсутствует фотография, возвращается https://vk.com/images/community_100.png.
photo_200stringURL квадратной фотографии сообщества с шириной 200 пикселей. Если у сообщества отсутствует фотография, возвращается https://vk.com/images/community_200.png.
photo_400stringURL квадратной фотографии сообщества максимального размера. Если у сообщества отсутствует фотография, возвращается https://vk.com/images/community_200.png.
is_memberintegerИнформация о том, является ли текущий пользователь участником сообщества. Возможные значения:    • 1 — является.    • 0 — не является.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

VKWebAppGetGroupInfoResult

Сигнализирует, что данные сообщества получены. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript{ detail: { type: "VKWebAppGetGroupInfoResult", data: { id: 166562603, name: "VK Mini Apps", screen_name: "vkappsdev", is_closed: 0, description: "Документация\n• VK Mini Apps и не только: dev.vk.com/guide\n• VKUI: vkcom.github.io/vkui-styleguide\n\nМакеты VKUI в Figma\n• figma.com/@vk\n\nБыстрое создание приложения\n• dev.vk.com/mini-apps/getting-started\n• npmjs.com/package/@vkontakte/create-vk-mini-app\n\nХостинг статики\n• npmjs.com/package/@vkontakte/vk-miniapps-deploy\n\nПолезные материалы\n• vk.com/@vkappsdev-poleznye-materialy\n• vk.com/@vkappsdev\n\nПесочница событий VK Bridge\n• vk.com/sandbox_app \n\nОбсуждения\n• VK Mini Apps: vk.com/topic-166562603_40071994\n• VKUI: vk.com/topic-166562603_40072026", members_count: 52104, photo_50: "https://sun1-95.userapi.com/s/v1/if1/SrTI7tgAv79jphLz5OHUTFRzURtWS0axJCL1cSIFzI5p8Ja7iJm1dKN-4SiGEdQJQOiBENHX.jpg?size=50x50&quality=96&crop=100,100,599,599&ava=1", photo_100: "https://sun1-95.userapi.com/s/v1/if1/7R1EtxtmMuhQSfGVD4Vt5Bzeq5TqHgpCCYG0hDi3RsIwfdOEiCht65OC_q1qOx1vfZIVHbn5.jpg?size=100x100&quality=96&crop=100,100,599,599&ava=1", photo_200: "https://sun1-95.userapi.com/s/v1/if1/MTmSdynigJoHXdY0krbacTurak0PmEfuhkT0c1aIKnRhgACEi1v0je0guGvhnnc1rZnQ6sZb.jpg?size=200x200&quality=96&crop=100,100,599,599&ava=1", photo_400: "https://sun1-95.userapi.com/s/v1/if1/_pd7kU0FVnLSN_a_W8U77BFyGa_qmXK0lDTKlRVnelRfHbmKr0RroAEoZ0jtm5ypMZKj2lbq.jpg?size=200x200&quality=96&crop=26,26,748,748&ava=1" is_member: 1 } } }

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

VKWebAppGetGroupInfoFailed

Информирует об ошибке, которая произошла при взаимодействии с платформой.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Смотрите раздел Обработка событий-результатов.

Песочница

VKWebAppGetGroupInfo