API
群信息读取
读取会话与成员信息;机器人须为活跃参与者。
鉴权: Authorization: Bearer sbot_…
GET
Bot Token/api/v1/bots/getMyChatsgetMyChats列出机器人所在会话
列出当前机器人作为活跃参与者的会话,可用于同步本地会话列表。
- 可选 query:
type(group/private,缺省全部)、limit(1–500,默认 200) - 返回:
{ chats: [{ chat_id, type, title, member_role?, updated_at? }], total }
GET
Bot Token/api/v1/bots/getChatgetChat获取会话信息
查询单条会话(私聊或群)的基础信息;机器人必须为该会话的活跃参与者。
- 必填 query:
chat_id(会话 ID) - 返回:
{ id, type, title?, name?, member_count?, pinned_message_id? }
GET
Bot Token/api/v1/bots/getChatMembergetChatMember获取群成员信息
查询群内某成员的状态;返回成员资料、所在角色与权限。
- 必填 query:
chat_id、user_id - 返回:
{ user: { id, username?, first_name?, is_bot }, status }
GET
Bot Token/api/v1/bots/getChatMemberCountgetChatMemberCount获取群成员人数
获取群成员人数。
- 必填 query:
chat_id - 返回:
{ count }
GET
Bot Token/api/v1/bots/getChatAdministratorsgetChatAdministrators获取群管理员列表
群管理员(含群主)列表。
- 必填 query:
chat_id - 返回:
administrators[](每项含user与status)
