Mivra LogoMivra API K 简体中文

#setWebhook

使用此方法指定一个 URL,机器人有更新时将通过 HTTPS POST 向该地址推送 JSON 序列化的 Update 对象。请求失败(非 2xx)会自动重试并在多次尝试后放弃。成功返回 True。

参数

参数类型必需说明
urlStringYesHTTPS 回调地址;传空字符串可删除 Webhook
certificateInputFileOptional自签名证书公钥(当前版本不支持,请使用受信任证书)
ip_addressStringOptional固定回调源 IP(当前版本不支持)
max_connectionsIntegerOptional回调最大并发连接数 1–100,默认 40
allowed_updatesArray of StringOptionalJSON 序列化的更新类型白名单;空数组表示接收除 chat_member 外全部类型
drop_pending_updatesBooleanOptional设置为 True 时丢弃设置前积累的更新
secret_tokenStringOptional1–256 位密钥;设置后每次回调都带请求头 X-Telegram-Bot-Api-Secret-Token

示例

curl -X POST "https://mivra.im/bot<TOKEN>/setWebhook" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhook","secret_token":"my-secret-123","max_connections":40}'

备注

Webhook 端口仅支持 443、80、88、8443。

只要设置了 Webhook,getUpdates 就不再返回更新。

请始终校验 secret_token 请求头,防止伪造回调。