浏览文档目录

API

群信息读取

读取会话与成员信息;机器人须为活跃参与者。

鉴权: Authorization: Bearer sbot_…

GET/api/v1/bots/getMyChats
Bot Token

getMyChats列出机器人所在会话

列出当前机器人作为活跃参与者的会话,可用于同步本地会话列表。

  • 可选 query:type (group / private,缺省全部)、limit (1–500,默认 200)
  • 返回:{ chats: [{ chat_id, type, title, member_role?, updated_at? }], total }
GET/api/v1/bots/getChat
Bot Token

getChat获取会话信息

查询单条会话(私聊或群)的基础信息;机器人必须为该会话的活跃参与者。

  • 必填 query:chat_id(会话 ID)
  • 返回:{ id, type, title?, name?, member_count?, pinned_message_id? }
GET/api/v1/bots/getChatMember
Bot Token

getChatMember获取群成员信息

查询群内某成员的状态;返回成员资料、所在角色与权限。

  • 必填 query:chat_id、user_id
  • 返回:{ user: { id, username?, first_name?, is_bot }, status }
GET/api/v1/bots/getChatMemberCount
Bot Token

getChatMemberCount获取群成员人数

获取群成员人数。

  • 必填 query:chat_id
  • 返回:{ count }
GET/api/v1/bots/getChatAdministrators
Bot Token

getChatAdministrators获取群管理员列表

群管理员(含群主)列表。

  • 必填 query:chat_id
  • 返回:administrators[](每项含 user 与 status)