API

チャットを読み取る

チャットとメンバー情報を読み取る; ボットはアクティブな参加者である必要があります。

認証: Authorization: Bearer sbot_…

GET/api/v1/bots/getMyChats
Bot Token

getMyChats

ボットがアクティブな参加者であるチャットのリスト(Webhook履歴が不完全な場合に便利)。

  • オプションのクエリ: type (group / private、デフォルトはすべて)、limit (1–500、デフォルトは200)
  • Returns: { chats: [{ chat_id, type, title, member_role?, updated_at? }], total }
GET/api/v1/bots/getChat
Bot Token

getChatチャットする

プライベートまたはグループチャットの基本情報を照会します; ボットはアクティブな参加者でなければなりません。

  • 必要なクエリ: chat_id (セッション ID)
  • リターン:{ id, type, title?, name?, member_count?, pinned_message_id? }
GET/api/v1/bots/getChatMember
Bot Token

getChatMemberチャットメンバーを取得する

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

  • 必須クエリ:chat_iduser_id
  • リターン:{ user: { id, username?, first_name?, is_bot }, status }
GET/api/v1/bots/getChatMemberCount
Bot Token

getChatMemberCountgetチャットメンバー数

グループメンバーの数を取得します。

  • 必須クエリ:chat_id
  • リターン:{ count }
GET/api/v1/bots/getChatAdministrators
Bot Token

getChatAdministratorsgetChat管理者

グループ管理者のリスト (グループ所有者を含む)。

  • 必須クエリ:chat_id
  • 戻り値: administrators[] (各アイテムには userstatus が含まれます)