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

GET/chats/{chatId}/members/me

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

Пример запроса:

BASH

Скопировать

curl -X GET "https://platform-api.max.ru/chats/{chatId}/members/me" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

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

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

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

Параметры

chatId
integer <int64>
\-?\d+

ID чата

Результат

user_id
integer <int64>

Идентификатор пользователя или бота

first_name
string

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

last_name
string Nullable optional

Отображаемая фамилия пользователя. Для ботов это поле не возвращается

username
string Nullable

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

is_bot
boolean

true, если это бот

last_activity_time
integer <int64>

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

name
string Nullable

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

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" "can_call" "edit_link" "post_edit_delete_message" "edit_message" "delete_message"

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

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

alias
string optional

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

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