API

我们为开发人员提供两种 API。Bot API允许您轻松创建将 TG纸飞机 消息用于接口的程序。TG纸飞机 API 和 TDLib允许您构建自己的自定义 TG纸飞机 客户端。欢迎您免费使用这两个 API。

您还可以将TG纸飞机小部件添加到您的网站。

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

---

机器人 API

此 API 允许您将机器人连接到我们的系统。TG纸飞机机器人是不需要额外电话号码来设置的特殊帐户。这些帐户用作在服务器上某处运行的代码的接口。

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

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

机器人开发者还可以利用我们的支付 API来接受来自世界各地 TG纸飞机 用户的支付。

---

TDLib – 建立你自己的TG纸飞机

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

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

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

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

---

电报 API

此 API 允许您构建自己的自定义 TG纸飞机 客户端。它对所有希望在我们的平台上创建 TG纸飞机 应用程序的开发人员 100% 开放。随意研究现有 TG纸飞机 应用程序的开源代码，了解这里的工作原理。不要忘记在我们的系统中注册您的应用程序。

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

入门

创建应用程序

如何获取您的应用程序标识符并创建一个新的 TG纸飞机 应用程序。

用户授权

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

两因素身份验证

如果他们启用了 2FA，如何登录到用户的帐户，如何更改密码。

二维码登录

二维码登录流程

错误处理

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

处理不同的数据中心

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

处理更新

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

处理推送通知

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

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

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

频道统计

TG纸飞机 提供频道和超级组的详细频道统计信息。

调用方法

调用方法的附加选项。

上传和下载文件

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

分页

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

客户端配置

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

安全

秘密聊天，端到端加密

端到端加密消息传递。

安全指南

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

完美的前向保密

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

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

端到端加密呼叫。

优化

客户端优化

促进 API 交互的方法。

API 方法

可用方法列表

可用高级方法的列表。

API TL 模式，作为 JSON

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

可用层列表

可用架构版本的列表。

其他文章

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

如何使用 MTProto API 使用机器人。

命令

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

纽扣

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

内联查询

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

游戏

Bots 可以为用户提供 HTML5 游戏，可以单人玩，也可以组队和一对一聊天；如何在 MTProto API 中处理游戏。

搜索和过滤器

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

民意调查

TG纸飞机 允许发送民意调查和测验，可以在聊天和频道中由数千甚至数百万用户投票。

反应

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

邀请链接和加入请求

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

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

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

讨论组

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

频道评论和消息线程

由于消息线程，TG纸飞机 允许对频道帖子或通用群组消息发表评论。

管理员日志

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

固定消息

TG纸飞机 允许将多条消息固定在特定聊天之上。

提及

TG纸飞机 允许在紧急情况下提及其他用户，并快速导航到这些提及以尽快阅读它们。

预定消息

TG纸飞机 允许调度消息。

实时地理位置

TG纸飞机 允许在聊天中发送用户的实时地理位置，可选择设置邻近警报。

最小构造函数

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

帐户删除

如果忘记了2FA密码，如何重置帐户。

导入的消息

TG纸飞机 允许从国外聊天应用程序导入消息和媒体。

电报护照

如何使用 MTProto API 直接使用TG纸飞机 Passport 。

电报支付

如何使用 MTProto API 直接使用 TG纸飞机 Payments。

带有消息实体的样式文本

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

使用动画表情符号

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

使用动画骰子

TG纸飞机 支持发送动画骰子表情符号。

消息草稿

如何处理邮件草稿

文件夹

使用文件夹

最高同行评级

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

处理文件引用

如何处理文件引用。

无缝电报登录

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

网络事件

在与 HTML5 游戏和支付网关网站交互时，TG纸飞机 应用程序应公开以下 JS API。