Получение информации о членстве в чате

GET/chats/{chatId}/members/me

Возвращает информацию о членстве текущего бота в чате.

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти в разделе платформы MAX для партнёров Чат-бот и мини-приложение → Настроить

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chatId
integer <int64>
\-?\d+

ID чата

Результат

user_id
integer <int64>

ID пользователя

first_name
string

Отображаемое имя пользователя

last_name
string Nullable

Отображаемая фамилия пользователя

name
string Nullable optional

Устаревшее поле, скоро будет удалено

username
string Nullable

Уникальное публичное имя пользователя. Может быть null, если пользователь недоступен или имя не задано

is_bot
boolean

true, если пользователь является ботом

last_activity_time
integer <int64>

Время последней активности пользователя в MAX (Unix-время в миллисекундах). Может быть неактуальным, если пользователь отключил статус "онлайн" в настройках.

description
string Nullable optional

до 16000 символов

Описание пользователя. Может быть null, если пользователь его не заполнил

avatar_url
string optional

URL аватара

full_avatar_url
string optional

URL аватара большего размера

last_access_time
integer <int64>

Время последней активности пользователя в чате. Может быть устаревшим для суперчатов (равно времени вступления)

is_owner
boolean

Является ли пользователь владельцем чата

is_admin
boolean

Является ли пользователь администратором чата

join_time
integer <int64>

Дата присоединения к чату в формате Unix time

permissions
ChatAdminPermission[] Nullable

Items Enum: "read_all_messages" "add_remove_members" "add_admins" "change_chat_info" "pin_message" "write" "edit_link"

Перечень прав пользователя. Возможные значения:

"read_all_messages" — Читать все сообщения.
"add_remove_members" — Добавлять/удалять участников.
"add_admins" — Добавлять администраторов.
"change_chat_info" — Изменять информацию о чате.
"pin_message" — Закреплять сообщения.
"write" — Писать сообщения.
"edit_link" — Изменять ссылку на чат.

alias
string optional

Заголовок, который будет показан на клиенте

Если пользователь администратор или владелец и ему не установлено это название, то поле не передается, клиенты на своей стороне подменят на "владелец" или "админ"