跳至主要內容

API 方法矩陣:41 端點、7 分類、風險分級與 DocOnly 方法

按分類速查的 MPChat Bot API 方法索引,含支援狀態、風險分級(L0-L3)、MP 差異,以及哪些高危方法屬 DocOnly。

索引級,非參數級。方法狀態與欄位定義以 core.mp.net/bots 為準。風險:L0 唯讀、L1 低寫入、L2 中寫入、L3 高危。DocOnly 方法絕不可在流水線中自動執行。


總覽

41 個端點(37 個唯一方法名),分 7 類。狀態值:Supported、Not Supported(501)、MP Difference、MP Extension。

Core(5)

方法

HTTP

狀態

風險

備註

getMe

GET/POST

Supported

L0

驗證 token;無 body。

getUpdates

GET/POST

Supported

L0

Webhook 啟用時 409。

logOut

POST

Supported

L3

使 token 失效;DocOnly。

Message(7)

方法

狀態

風險

備註

sendMessage

MP Difference

L1

支援 reply_markup.web_app;不支援完整回流。

sendPhoto

MP Difference

L1

公網 URL / multipart;無 file_id 複用。

sendVideo

MP Difference

L1

同上。

sendDocument

MP Difference

L1

同上。

sendChatAction

Not Supported

-

回傳 501。

sendLocation

Not Supported

-

回傳 501。

sendPoll

Not Supported

-

回傳 501。

Management(11)

方法

狀態

風險

備註

copyMessage / copyMessages

Supported

L1

無 forward_from;批量無部分成功。

forwardMessage / forwardMessages

Supported

L1

含 forward_from。

editMessageText

Supported

L1

僅 Bot 自身文字。

pinChatMessage / unpinChatMessage

Supported

L2

僅群聊。

deleteMessage / deleteMessages

Supported

L3

DocOnly;批量任一失敗則整體失敗。

recallMessage / recallMessages

MP Extension

L3

MP 撤回;deleteMessage 仍是相容刪除。

Group(11)

方法

狀態

風險

備註

getChat / getChatAdministrators

Supported

L0

ChatFullInfo 子集;含 MP 擴展權限欄位。

getChatMember / getChatMemberCount

Supported

L0

禁言成員回傳 restricted。

setChatTitle / setChatDescription

Supported

L2

需改資訊權限或 owner。

setChatPhoto

MP Difference

L2

URL/multipart;無 file_id。

deleteChatPhoto

Supported

L2

需權限。

banChatMember

MP Difference

L3

禁言非踢人;DocOnly。

unbanChatMember

Supported

L2

解除禁言。

leaveChat

Supported

L3

Bot 退群;DocOnly。

Bot Commands(4)、Webhook(4)、User(1)

方法

狀態

風險

備註

getMyCommands

Supported

L0

讀指令選單。

setMyCommands / deleteMyCommands

Supported

L2

指令格式 ^[a-z0-9_]{1,32}$。

getWebhookInfo

Supported

L0

唯讀狀態。

setWebhook / deleteWebhook

Supported

L3

必須 HTTPS;DocOnly。

getUserProfilePhotos

Supported

L0

最多一組頭像。

MP 差異與 DocOnly 彙總

  • MP 差異(6):sendMessage、sendPhoto、sendVideo、sendDocument、setChatPhoto、banChatMember。

  • 不支援 / 501(3):sendChatAction、sendLocation、sendPoll。

  • DocOnly(絕不自動執行):logOut、leaveChat、deleteMessage(s)、banChatMember、setWebhook、deleteWebhook。

相關文章

大量 Telegram 方法未被 MP 暴露。本矩陣為索引;欄位級細節請在官方頁面確認。

是否回答了您的問題?