Telegram API
我们为开发者提供两种 API。Bot API允许您轻松创建使用 Telegram 消息作为界面的程序。Telegram API 和 TDLib允许您构建自己的自定义 Telegram 客户端。欢迎您免费使用这两种 API。
您还可以将Telegram Widgets添加到您的网站。
欢迎设计师为 Telegram创建动画贴纸或自定义主题。
机器人 API
此 API 允许您将机器人连接到我们的系统。Telegram机器人是特殊帐户,无需设置额外的电话号码。这些帐户可作为在您的服务器上某处运行的代码的接口。
要使用此功能,您无需了解我们的 MTProto 加密协议的工作原理——我们的中介服务器将为您处理所有加密和与 Telegram API 的通信。您可以通过一个简单的 HTTPS 接口与此服务器通信,该接口提供简化版的 Telegram API。
在此处了解有关 Bot API 的更多信息 »
机器人开发人员还可以利用我们的支付 API接受来自世界各地 Telegram 用户的付款。
TDLib – 构建你自己的 Telegram
即使您希望实现最大程度的自定义,也不必从头开始创建应用。尝试我们的Telegram 数据库库(简称 TDLib),这是一款面向第三方开发人员的工具,可让您轻松构建快速、安全且功能丰富的 Telegram 应用。
TDLib 负责所有网络实现细节、加密和本地数据存储,以便您可以投入更多时间进行设计、响应式界面和精美的动画。
TDLib 支持所有 Telegram 功能,使在任何平台上开发 Telegram 应用变得轻而易举。它可以在 Android、iOS、Windows、macOS、Linux 和几乎任何其他系统上使用。该库是开源的,并且与几乎任何编程语言兼容。
Telegram API
此 API 允许您构建自己的自定义 Telegram 客户端。它对所有希望在我们的平台上创建 Telegram 应用程序的开发人员完全开放。您可以随意研究现有 Telegram 应用程序的开源代码,以了解这里的工作原理。不要忘记在我们的系统中注册您的应用程序。
- 入门
- 安全
- 优化
- API 方法
入门
- 创建应用程序
如何获取您的应用程序标识符并创建新的 Telegram 应用程序。 - 用户授权
如何注册用户电话以开始使用 API。 - 双重身份验证
如果用户启用了 2FA,如何登录用户帐户,如何更改密码。 - 二维码登录
二维码登录流程 - 错误处理
如何正确处理API返回错误。 - 处理不同的数据中心
如何连接最近的DC接入点以便更快的与API交互,以及开发客户端时需要注意的事项。 - 处理更新
如何订阅更新并正确处理它们。 - 处理推送通知
如何订阅并正确处理它们。 - 频道、超级组、千兆组和基本组
如何处理通道、超级组、千兆组、基本组,以及它们之间有什么区别。。 - 论坛
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 允许从国外聊天应用导入消息和媒体。 - Telegram护照
如何使用MTProto API 直接使用Telegram Passport 。 - Telegram支付
如何使用 MTProto API 直接使用 Telegram Payments。 - 带有消息实体的样式文本
如何使用消息实体创建样式文本 - 使用贴纸
Telegram 客户端支持显示动画、静态和视频贴纸。 - 使用自定义表情符号
Telegram 允许直接在消息中包含自定义动画、静态和视频表情符号。 - 使用动画表情符号
图形电报客户端应该将表情符号转换为各自的动画版本。 - 使用动画骰子
Telegram 支持发送动画骰子表情符号。 - 邮件草稿
如何处理邮件草稿 - 文件夹
使用文件夹 - 最高同行评级
如果启用,顶级同行的评级将表明某个类别中经常使用的同行的相关性(经常发送消息的用户、经常使用的机器人、内联机器人、经常访问的频道等)。 - 处理文件引用
如何处理文件引用。 - 无缝电报登录
处理无缝电报登录 URL 授权请求。 - 壁纸
如何使用聊天背景。 - 通知声音
如何使用聊天通知声音。 - 消息转录
如何转录语音消息。 - 信息翻译
Telegram 允许翻译聊天消息,Telegram Premium用户甚至可以启用实时聊天翻译。 - 原生反垃圾邮件系统
拥有一定数量成员的超级群组的管理员可以选择释放 Telegram 自己的反垃圾邮件算法的全部主动能力——为自动垃圾邮件过滤器启用新的积极模式。 - 可收集的用户名
Telegram 用户可以让其他人通过用户名轻松地联系他们或找到他们的公共群组和频道:客户端还可以为他们拥有的帐户、超级群组和频道 分配多个可收集的用户名。 - 渠道提升
Telegram Premium用户可以授予他们最喜欢的频道额外的功能,比如通过给予加速来发布故事的能力。 - 赠品和礼物
Telegram频道管理员可以推出赠品活动,在其关注者中随机分发Telegram Premium订阅和其他礼物,以换取提升。 - 操作栏
有时,当通过私人或秘密聊天与 Telegram 用户互动时,必须在聊天顶部显示一个操作栏,提供方便的操作按钮或有关用户的通知。 - 已保存的消息
已保存消息聊天允许用户为消息和媒体添加书签:它是您可能想要发送或转发的任何消息或媒体的个人云存储。 - 联系方式
使用 API 中的联系人。 - 黑名单
使用阻止列表。 - 附近的用户和聊天
如何使用基于地理位置的功能,例如 geochats 和附近的用户功能。 - Web 事件
在与 HTML5 游戏和支付网关网站交互时,Telegram 应用程序应公开以下 JS API。 - 取出
Telegram 的 API 允许用户通过外卖 API 导出自己的所有信息。