Telegram中文:TG API 详解

ic_date 2024-06-17
博客列表

电报 API有那些?


Telegram 提供了多种 API 和开发工具,允许开发者创建机器人、应用和与 Telegram 平台集成。以下是主要的 Telegram API 类型及其详细说明:


1. Telegram Bot API

简介:Telegram Bot API 是一个用于创建和管理 Telegram 机器人(bots)的接口。通过 Bot API,开发者可以与 Telegram 服务器进行交互,创建和管理机器人,处理消息和用户请求。

功能

  • 发送消息:发送文本、图片、视频、文档等各种消息类型。

  • 接收更新:接收用户发送到机器人或与机器人交互的更新。

  • 处理命令:定义和处理用户发送给机器人的命令。

  • 管理聊天:创建和管理群组、频道、超级群组中的机器人角色。

  • 自定义键盘:创建自定义键盘和内联按钮,增强用户交互体验。

API 端点示例

  • /sendMessage:发送文本消息。

  • /getUpdates:获取最新的更新。

  • /setWebhook:设置回调 URL,接收更新。

文档Telegram Bot API 文档

2. Telegram MTProto API

简介:Telegram MTProto API 是 Telegram 的核心 API,用于直接与 Telegram 服务器进行通信。这种 API 主要用于 Telegram 客户端(如官方桌面版和移动版)之间的通讯,但也可以用于开发第三方应用程序。

功能

  • 用户认证:处理用户登录和验证。

  • 消息传递:发送和接收消息,管理聊天记录。

  • 文件传输:上传和下载文件,处理多媒体内容。

  • 群组和频道管理:创建和管理群组、频道、超级群组。

  • 用户信息:获取用户资料和聊天信息。

API 端点示例

  • auth.sendCode:发送验证码以进行用户验证。

  • messages.sendMessage:发送消息到指定对话。

  • messages.getHistory:获取消息历史记录。

文档Telegram MTProto API 文档

3. Telegram Passport API

简介:Telegram Passport 是 Telegram 提供的一种安全的个人身份认证服务,允许用户在 Telegram 内部或与第三方服务共享身份信息。

功能

  • 提交文件:用户可以通过 Passport 提交身份证明文件,如护照、驾照等。

  • 处理身份验证:第三方应用程序可以通过 Telegram Passport 进行用户身份验证,减少用户重复填写信息的麻烦。

API 端点示例

  • passport.setPassportDataErrors:设置提交的身份证明文件错误。

  • passport.getUserProfilePhotos:获取用户的头像照片。

文档Telegram Passport API 文档

4. Telegram Web Bots API

简介:Web Bots API 是专门为 Web 应用程序设计的 API,允许机器人通过 Web 页面与用户交互。

功能

  • 嵌入聊天:在网页中嵌入 Telegram 机器人聊天窗口。

  • 管理 Webhooks:设置和管理 Webhook 以接收用户交互。

API 端点示例

  • /setWebhook:设置 Webhook,以便从 Telegram 接收更新。

  • /deleteWebhook:删除 Webhook 设置。

文档Telegram Web Bots API 文档

5. Telegram Payments API

简介:Telegram Payments API 允许开发者在机器人中集成支付功能,使用户能够直接在 Telegram 中进行付款。

功能

  • 创建支付订单:创建支付订单,并与用户交互。

  • 处理支付:接收支付确认和处理付款结果。

API 端点示例

  • /sendInvoice:发送支付发票,允许用户进行付款。

  • /answerPreCheckoutQuery:处理预检查支付查询。

文档Telegram Payments API 文档


电报 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 和几乎任何其他系统上使用。该库是开源的,并且与几乎 任何编程语言兼容。

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

电报API

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

  • 入门

  • 安全

  • 优化

  • API 方法

入门

创建应用程序

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

用户授权

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

双重身份验证

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

二维码登录

二维码 登录流程

错误处理

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

处理不同的数据中心

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

处理更新

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

处理推送通知

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

频道、超级组、千兆组和基本组

如何处理频道、超级组、千兆组、基本组,以及它们之间的区别是什么。

论坛

Telegram 允许创建包含多个不同主题的论坛。

渠道统计

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

调用方法

调用方法的附加选项。

上传和下载文件

如何正确传输大量数据。

分页

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

客户端配置

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

安全

秘密聊天,端到端加密

端到端加密消息传递。

安全指南

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

完美前向保密

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

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

端到端加密通话。

优化

客户端优化

增强 API 交互的方法。

API 方法

可用方法列表

可用的高级方法的列表。

API TL 模式, 作为 JSON

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

可用图层列表

可用架构版本的列表。


总结

Telegram 提供了多种 API,分别用于不同的功能和场景,包括创建和管理机器人、处理消息传递、处理用户身份认证、集成支付功能等。详细了解这些 API 并使用相应的文档,可以帮助开发者创建功能丰富、集成良好的 Telegram 应用和服务。