MUSUWAMUSUWA

API

プロフィール

ボットのプロフィールとコマンドメニューを読み取り、更新します。

インデックスに戻る

認証: Authorization: Bearer sbot_…

GET/api/v1/bots/me
Bot Token

me現在のロボット情報を取得する

基于 Bot Token 解析并返回机器人基础信息。

  • 戻り値: id、name、username、review_status、status、scopes、system_user_id、group_privacy (グループ プライバシー モード、デフォルト true)
POST/api/v1/bots/setMyShortDescription
Bot Token

setMyShortDescription簡単な説明を設定する

ロボットがホームページ/プライベート チャット「ⓘ」パネルの上部に表示する短い説明 (≤120) を設定します。

  • オプション: short_description (≤120、空のままにします)
  • リターン：bot_id / short_description
GET/api/v1/bots/getMyShortDescription
Bot Token

getMyShortDescription簡単な説明を取得する

`setMyShortDescription` と組み合わせて、クライアントのバックフィルを簡単にします。

  • リターン：{ short_description }
POST/api/v1/bots/setMyDescription
Bot Token

setMyDescriptionセットの説明

[バージョン情報] パネルでボットの複数行の説明を設定します。

  • オプション: description (≤512、空白のままにしてクリア)
  • リターン：bot_id / about
GET/api/v1/bots/getMyDescription
Bot Token

getMyDescription説明の取得

`setMyDescription` とペアリングしました。

  • 戻り値: { description } (つまり Bot.about)
POST/api/v1/bots/setMyCommands
Bot Token

setMyCommandsコマンドの設定

`/start`、`/help` およびその他のコマンドを構成します。アプリに `/` と入力すると、ドロップダウン プロンプトが表示されます。 `scope` / `language_code` でグループ化できます。

  • 必須: commands ({ command, description }[]、1..100 項目、コマンドのみ a-z0-9_、1..32 文字)
  • オプション: scope (default / all_private_chats / all_group_chats / all_chat_administrators など、または { type, chat_id?, user_id? })
  • 任意：language_code (BCP-47)
  • リターン：{ ok: true }
GET/api/v1/bots/getMyCommands
Bot Token

getMyCommandsコマンドの取得

`setMyCommands` とペアリングされ、`scope` / `language_code` でフィルタリング可能。

  • オプションのクエリ：scope、language_code
  • リターン：{ commands }
POST/api/v1/bots/deleteMyCommands
Bot Token

deleteMyCommands削除コマンド

特定の `scope` + `language_code` の組み合わせにあるコマンド リストを削除します。

  • 任意：scope、language_code
  • リターン：{ ok: true }
POST/api/v1/bots/setMyFriendRequestMode
Bot Token

setMyFriendRequestModeフレンドリクエストモードを設定する

`auto_accept` / `auto_reject` / `manual` を構成します。 `manual` は、`answerFriendRequest` を通じてロボットによって決定されます。

  • 必須：friend_request_mode
  • リターン：{ friend_request_mode }
GET/api/v1/bots/getMyFriendRequestMode
Bot Token

getMyFriendRequestMode友達リクエストモードを取得

`setMyFriendRequestMode` とペアリングしました。

  • リターン：{ friend_request_mode }
POST/api/v1/bots/setMyGroupPrivacy
Bot Token

setMyGroupPrivacyグループを設定 Privacy Mode

ベンチマーク TG BotFather `/setprivacy`: `enabled=false` の場合、ロボットはグループ内のすべての通常のメッセージを受信します。プライベート チャットは影響を受けません。

  • 必須: enabled (ブール値、true=プライバシーを有効にする / false=すべてのグループ メッセージを受信する)
  • group_privacy (enabled と同義) を渡すこともできます。
  • リターン：{ group_privacy }
GET/api/v1/bots/getMyGroupPrivacy
Bot Token

getMyGroupPrivacyグループを取得 Privacy Mode

`setMyGroupPrivacy` とペアリングします。開発者コンソールは、`PATCH /bots/my/:id` 経由で `group_privacy` を変更することもできます。

  • リターン：{ group_privacy }
GET/api/v1/bots/getFriendRequests
Bot Token

getFriendRequests友達リクエストをリストする

現在のロボットが受信した保留中のアプリケーションをリストします。まずポリシーを `manual` に変更する必要があります。

  • 戻り値: items[] (id、fromUserId、fromUsername、requestMessage、source、status を含む)
POST/api/v1/bots/answerFriendRequest
Bot Token

answerFriendRequest友達リクエストに答える

`manual` モードでは、ロボットは友達の申請を積極的に承認または拒否します。承諾後、両当事者間の関係は自動的に有効になります。

  • 必須：friendship_id、action (accept / reject)
  • 戻り値: 処理結果
POST/api/v1/bots/verify-token
无（请求体带 token）

verify-tokenBot Token を確認してください

デバッグの場合: リクエスト本文で `token` を使用して、有効性を確認します (パブリック エンドポイント)。

  • 必須：token
  • 戻り値: bot オブジェクトまたはエラー