跳转到主要内容

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 暴露。本矩阵为索引;字段级细节请在官方页面确认。

这是否解答了您的问题?