Telegram API 接口说明

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

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

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


机器人API

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

要使用它,您无需了解有关我们的 MTProto 加密协议如何工作的任何信息 - 我们的中间服务器将为您处理所有加密以及与 Telegram API 的通信。您可以通过一个简单的 HTTPS 接口与该服务器进行通信,该接口提供了 Telegram API 的简化版本。

机器人开发人员还可以利用我们的 Payments API 接受世界各地 Telegram 用户的付款。


TDLib – 构建您自己的 Telegram

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

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

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


电报API

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

  • 入门
  • 安全
  • 优化
  • API方法

入门

创建应用程序

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

用户授权

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

双因素身份验证

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

二维码登录

二维码登录流程

错误处理

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

处理不同的数据中心

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

处理更新

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

处理 PUSH 通知

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

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

如何处理通道、超级组、千兆组、基本组以及它们之间的区别。

论坛

Telegram 允许创建具有多个不同主题的论坛。

频道统计

Telegram 提供频道和超级群组的详细频道统计数据。

调用方法

调用方法的附加选项。

上传和下载文件

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

分页

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

客户端配置

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

安全

秘密聊天、端到端加密

端到端加密消息传递。

安全指南

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

完美的前向保密

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

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

端到端加密通话。

优化

客户端优化

促进 API 交互的方法。

API方法

可用方法列表

可用的高级方法的列表。

API TL 模式,JSON 形式

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

可用图层列表

可用架构版本的列表。

其他文章

使用 MTProto API 与机器人合作

如何使用 MTProto API 与机器人合作。

命令

机器人提供了一组可供用户私下或聊天中使用的命令。

纽扣

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

菜单按钮

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

内联查询

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

游戏

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

迷你应用程序

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

附件菜单

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

故事

Telegram 用户和频道可以通过 API 轻松发布和查看故事。

类似频道

该 API 提供了一种方法来获取类似主题的公共频道列表,这些频道是根据订阅者群的相似性进行选择的。

强调色

Telegram 用户和频道可以更改其个人资料页面及其消息的强调色和背景图案!

隐私设置

Telegram 允许用户指定精细的隐私设置,选择哪些用户可以或不能以某些方式与他们交互。

搜索和过滤器

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

民意调查

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

反应

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

表情符号状态

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

邀请链接和加入请求

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

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

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

讨论组

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

频道评论和消息线程

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

管理日志

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

固定消息

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

提及

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

预定消息

Telegram 允许安排消息。

实时地理位置

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

最小构造函数

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

帐户删除

如何删除 Telegram 帐户。

导入的消息

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

电报护照

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

电报付款

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

带有消息实体的样式文本

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

使用贴纸

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

使用自定义表情符号

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

使用动画表情符号

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

使用动画骰子

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

留言草稿

如何处理消息草稿

文件夹

使用文件夹

同行评级最高

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

处理文件引用

如何处理文件引用。

无缝电报登录

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

壁纸

如何使用聊天背景。

通知声音

如何使用聊天通知声音。

消息转录

如何转录语音消息。

留言翻译

Telegram 允许翻译聊天消息,Telegram Premium 用户甚至可以启用实时聊天翻译。

本机反垃圾邮件系统

拥有一定数量成员的超级组的管理员可以选择充分发挥 Telegram 自己的反垃圾邮件算法的主动力量 - 为自动垃圾邮件过滤器打开新的积极模式。

可收藏的用户名

Telegram 用户可以让其他人通过用户名轻松联系他们或找到他们的公共群组和频道:客户还可以将多个可收集的用户名分配给他们拥有的帐户、超级群组和频道。

渠道提升

Telegram Premium 用户可以向他们喜爱的频道授予附加功能,例如通过给予支持来发布故事的能力。

赠品和礼物

Telegram 频道管理员可能会推出赠品,在其关注者中随机分发 Telegram Premium 订阅和其他礼物,以换取奖励。

操作栏

有时,当通过私人或秘密聊天与 Telegram 用户交互时,必须在聊天顶部显示操作栏,提供方便的操作按钮或有关用户的通知。

已保存的消息

“保存的消息”聊天允许用户为消息和媒体添加书签:它是您可能想要发送或转发的任何消息或媒体的个人云存储。

联系方式

使用 API 中的联系人。

黑名单

使用阻止列表。

附近的用户&聊天

如何使用基于地理位置的功能,例如地理聊天和附近的用户功能。

网络事件

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

取出

Telegram 的 API 允许用户通过外卖 API 导出所有信息。