SuperAPI AI 工具集

telegram

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

用途:该技能是面向 Telegram Bot 开发的路由型参考,根据当前任务选择对应的参考文档,帮助开发者定位 bot 基础、aiogram 3 模式、webhook、键盘交互、inline 模式、Mini Apps 与支付等主题的正确资料。

主要能力与文档导航:新手入门看 bots-overview.md;bot 能力概览看 bot-features.md;API 方法与类型看 bot-api.md;webhook 配置与安全看 webhooks.md;aiogram 3 handlers/FSM 看 aiogram-patterns.md;键盘 UX 看 keyboard-design.md;inline 模式看 inline-mode.md;Mini Apps(Web Apps)看 mini-apps.md;支付(Stars)看 payments.md;认证(Login Widget、URL Auth)看 authentication.md;速率限制与性能看 performance.md。

必要用法与要点:文档列出关键禁止事项,包括同一 bot 不可同时使用轮询与 webhook;不可硬编码 token/密钥,应使用环境变量;callback_data 或日志中不得含密钥;必须响应 answer_callback_query,不可忽略;webhook handler 中不可做阻塞工作,应改用后台任务;不可在未校验 hash 的情况下信任 Login Widget 数据。完成标准为:webhook handler 校验 X-Telegram-Bot-Api-Secret-Token;键盘每行最多 2 个按钮并面向移动端;callback data 需校验而非盲目信任;handler 需幂等或具备去重。

版本说明:资料给出 aiogram 3.29.x–3.31.x 与 Bot API 10.1–10.3 的发布说明,包括富消息、临时消息、新 reply-markup 控件、webhook 路径 dispatcher 上下文丢失修复、parse_mode 修复与依赖升级等;3.28.x 对应 Bot API 10.0,新增 guest 模式更新、更丰富的投票/媒体流程、live photos 与 reaction 管理方法等。相关技能包括 PostgreSQL(数据库层)与 FastAPI(API 层)。具体价格、平台支持与完整安装步骤资料未提供。