API

电报 API

我们为开发者提供了两种 API。Bot API允许您轻松创建使用 Telegram 消息作为界面的程序。Telegram API 和 TDLib允许您构建自己的自定义 Telegram 客户端。欢迎您免费使用这两个 API。

您还可以将电报小部件添加到您的网站。

欢迎设计师为 Telegram 创建动画贴纸自定义主题

消防艇

此 API 允许您将机器人连接到我们的系统。Telegram 机器人是不需要额外电话号码即可设置的特殊帐户。这些帐户充当在服务器某处运行的代码的接口。

要使用它,您无需了解我们的 MTProto 加密协议的工作原理——我们的中间服务器将为您处理所有加密和与 Telegram API 的通信。您通过一个简单的 HTTPS 接口与该服务器通信,该接口提供了 Telegram API 的简化版本。

在此处了解有关 Bot API 的更多信息 »

机器人开发人员还可以使用我们的支付 API来接受来自世界各地 Telegram 用户的支付。

TDLib——建立你自己的电报

即使您正在寻找最大程度的自定义,也不必从头开始创建您的应用程序。试试我们的Telegram 数据库库(或简称为 TDLib),这是一种供第三方开发人员使用的工具,可以轻松构建快速、安全且功能丰富的 Telegram 应用程序。

TDLib 负责所有网络实现细节、加密本地数据存储,以便您可以将更多时间用于设计响应式界面和精美动画。

TDLib 支持所有 Telegram 功能,并使在任何平台上开发 Telegram 应用程序变得轻而易举。它可以在 Android、iOS、Windows、macOS、Linux 和几乎任何其他系统上使用。该库是开源的,几乎与任何编程语言兼容。

在此处了解有关 TDLib 的更多信息 »

电报 API

此 API 允许您构建自己的定制 Telegram 客户端。它对所有希望在我们平台上创建 Telegram 应用程序的开发人员 100% 开放。请随意研究现有 Telegram 应用程序的开源代码,以获取此处工作原理的示例。不要忘记在我们的系统中注册您的应用程序。

入门

创建应用程序

如何获取您的应用程序标识符并创建新的 Telegram 应用程序。

用户授权

如何注册用户的电话以开始使用 API。

双因素身份验证

如果用户启用了 2FA,如何登录到用户帐户,如何更改密码。

二维码登录

二维码登录流程

错误处理

如何正确处理 API 返回错误。

处理不同的数据中心

如何连接到最近的 DC 接入点以更快地与 API 交互,以及开发客户端时需要注意的事项。

处理更新

如何订阅更新并正确处理它们。

处理推送通知

如何正确订阅和处理它们。

通道、超组、千兆组和基本组

如何处理通道、超级组、千兆组、基本组,它们之间有什么区别。

渠道统计

Telegram 提供频道和超级组的详细频道统计信息。

调用方法

调用方法的附加选项。

上传和下载文件

如何正确传输大数据批次。

分页

如何从大型对象列表中获取结果。

客户端配置

MTProto API 有多个客户端配置参数,可以使用适当的方法获取这些参数。

安全

秘密聊天,端到端加密

端到端加密的消息传递。

安全准则

客户端应用程序中需要的重要检查。

完美前向保密

将临时授权密钥绑定到永久授权密钥。

语音和视频通话中的端到端加密

端到端加密调用。

优化

客户端优化

促进 API 交互的方法。

接口方法

可用方法列表

可用高级方法的列表。

API TL-schema作为 JSON

API 中使用的类型和方法的文本和 JSON 表示。

可用图层列表

可用架构版本的列表。

其他文章

使用机器人,使用 MTProto API

如何使用 MTProto API 与机器人一起工作。

命令

机器人提供了一组命令,用户可以在私下或聊天中使用这些命令。

纽扣

用户可以通过按钮甚至内联按钮与您的机器人进行交互,直接来自任何聊天 中的内联消息。

菜单按钮

机器人可以选择文本输入字段旁边显示的菜单按钮的行为。

内联查询

用户可以直接从任何聊天 中的文本输入字段通过内联查询与您的机器人进行交互。

游戏

机器人可以为用户提供 HTML5 游戏,让他们可以单独玩,也可以在群组和一对一聊天中相互竞争;如何在 MTProto API 中使用游戏。

网络应用

机器人可以为用户提供交互式HTML5 网络应用程序以完全取代任何网站

附件菜单

机器人可以安装附件菜单条目,提供方便访问的多功能网络应用程序。

搜索和过滤器

Telegram 允许在聊天中查找消息时应用详细的消息过滤器。这允许服务器根据文本查询甚至它们的类型来过滤消息,图形客户端通常使用此功能来实现聊天图库、聊天个人资料图片等功能。

投票

Telegram 允许发送民意测验和测验,可以在聊天和频道中由数千甚至数百万用户进行投票。

反应

Telegram 允许用户使用特定的表情符号对任何消息做出反应,触发可爱的 lottie 动画。

表情符号状态

Telegram 允许用户将表情符号或自定义表情符号设置为状态,以在聊天和个人资料中显示在他们的名字旁边。

邀请链接和加入请求

频道、基本组和超级组可能有一个公共用户名或一个私人邀请链接:私人邀请链接可以通过每个用户的加入请求进一步增强。

频道、超级群组和群组的管理员、禁止和默认权限

如何处理频道、组和超级组中的管理员权限、细化禁令和全局权限。

讨论组

可以作为讨论组关联到频道,以允许用户讨论帖子。

频道评论和消息线程

由于消息线程,Telegram 允许对频道帖子或通用组消息发表评论。

管理员日志

超级组和频道都提供所谓的管理员日志,最近相关超级组和频道操作的日志,例如代表管理员修改组/频道设置或信息、用户踢和禁止等。

置顶消息

Telegram 允许在特定聊天之上固定多条消息。

提及

Telegram 允许在遇到紧急问题时提及其他用户,并快速导航到这些提及的内容,以便尽快阅读它们。

预定消息

Telegram 允许安排消息。

实时地理位置

Telegram 允许在聊天中发送用户的实时地理位置,可选择设置接近警报。

最小构造函数

有时,在群聊更新中遇到的用户频道构造函数可能不包含有关用户的完整信息:如何处理此类构造函数。

帐户删除

如何删除电报帐户。

导入的消息

Telegram 允许从外国聊天应用程序导入消息和媒体。

电报护照

如何使用 MTProto API 直接使用Telegram Passport 。

电报支付

如何使用 MTProto API 直接使用电报支付。

带消息实体的样式化文本

如何使用消息实体创建样式文本

使用贴纸

Telegram 客户端支持显示动画、静态和视频贴纸。

使用自定义表情符号

Telegram 允许直接在消息中包含自定义动画、静态和视频表情符号。

使用动画表情符号

图形电报客户端应将表情符号转换为各自的动画版本。

使用动画骰子

Telegram 支持发送动画骰子表情符号。

留言草稿

如何处理消息草稿

文件夹

使用文件夹

最高同行评价

如果启用顶级对等点的评级表明某个类别中经常使用的对等点的相关性(经常发送消息的用户、经常使用的机器人、内联机器人、经常访问的频道等)。

处理文件引用

如何处理文件引用。

无缝电报登录

处理无缝电报登录 URL 授权请求。

壁纸

如何使用聊天背景。

通知声音

如何使用聊天通知声音。

消息转录

如何转录语音信息。

网络事件

在与 HTML5 游戏和支付网关网站交互时,Telegram 应用程序应公开以下 JS API。