Telegram API 文档
我们为开发者提供三种 API。Bot API 允许您轻松创建使用 Telegram 消息作为界面的程序。Telegram API 和 TDLib 允许您构建自己的自定义 Telegram 客户端。欢迎免费使用这些 API。最后,Gateway API 允许任何企业、应用或网站通过 Telegram 而不是传统短信发送验证码。
您还可以将 Telegram 小组件 添加到您的网站。
Bot API(机器人接口)
此 API 允许您将机器人连接到我们的系统。Telegram 机器人是特殊账户,无需额外的电话号码即可设置。这些账户作为运行在您服务器上的代码的接口。
使用此 API,您无需了解 MTProto 加密协议的工作原理 —— 我们的中间服务器将为您处理所有加密和与 Telegram API 的通信。您通过简单的 HTTPS 接口与此服务器通信,该接口提供 Telegram API 的简化版本。
了解更多关于 Bot API机器人开发者还可以使用我们的支付 API 接受来自全球 Telegram 用户的付款。
TDLib(数据库库)
使用我们的 Telegram 数据库库构建您自己的 Telegram 应用 —— 这是一个面向第三方开发者的工具,可以轻松构建快速、安全且功能丰富的 Telegram 应用。
TDLib 处理所有网络实现细节、加密和本地数据存储,因此您可以将更多时间用于设计、响应式界面和精美动画。TDLib 支持所有 Telegram 功能,使在任何平台上开发 Telegram 应用变得轻而易举。它可以在 Android、iOS、Windows、macOS、Linux 和几乎任何其他系统上使用。该库是开源的,与几乎任何编程语言兼容。
了解更多关于 TDLibGateway API(网关接口)
Telegram Gateway API 允许任何企业、应用或网站通过 Telegram 而不是传统短信发送授权验证码 —— 提供了一种强大而便捷的方式来降低成本,同时提高向 Telegram 10 亿月活跃用户发送验证码的安全性和速度。
用户将在 Telegram 内的特殊聊天中即时收到带有验证码的消息。Telegram 的 Gateway API 完全免费测试。
了解更多Telegram API(完整接口)
此 API 允许您构建自己的自定义 Telegram 客户端。它对所有希望在我们平台上创建 Telegram 应用的开发者 100% 开放。
欢迎研究现有 Telegram 应用的开源代码,了解这里的工作原理示例。别忘了在我们的系统中注册您的应用。
注册您的应用入门指南
创建应用
如何获取您的应用标识符并创建新的 Telegram 应用。
用户授权
如何注册用户的手机以开始使用 API。
两步验证
如果用户启用了两步验证,如何登录用户账户,如何更改密码。
二维码登录
二维码登录流程。
错误处理
如何正确处理 API 返回的错误。
处理不同的数据中心
如何连接到最近的数据中心访问点以更快地与 API 交互。
处理更新
如何订阅更新并正确处理它们。
处理推送通知
如何订阅和正确处理推送通知。
频道、超级群组、大型群组和基本群组
如何处理频道、超级群组、大型群组、基本群组,以及它们之间的区别。
论坛
Telegram 允许创建具有多个不同主题的论坛。
频道私信
Telegram 支持频道私信,也可用于建议频道帖子。
频道统计
Telegram 为频道和超级群组提供详细的统计数据。
调用方法
调用方法的其他选项。
上传和入口文件
如何正确传输大数据批次。
分页
如何从大型对象列表中获取结果。
客户端配置
MTProto API 有多个客户端配置参数。
机器人开发
使用 MTProto API 与机器人交互
如何使用 MTProto API 与机器人交互。
Bot API 对话 ID
在 MTProto peer ID 和 Bot API 对话 ID 之间转换。
命令
机器人提供一组可在私聊或群聊中使用的命令。
按钮
用户可以通过按钮甚至内联按钮与您的机器人交互。
菜单按钮
机器人可以选择文本输入框旁边显示的菜单按钮的行为。
内联查询
用户可以通过内联查询与您的机器人交互。
游戏
机器人可以为用户提供 HTML5 游戏,可单人玩或相互竞争。
小程序
机器人可以为用户提供交互式 HTML5 小程序,完全替代任何网站。
联盟计划
开发者可以为其小程序开设联盟计划。
附件菜单
机器人可以安装附件菜单条目,提供便捷访问的小程序。