Telegram APIs 是什么?三类 API 与 TDLib 能做什么
core.telegram.org 是 Telegram 官方面向开发者的 API 文档站。它把可用的接口分成三类：Bot API、Telegram API / TDLib、Gateway API。如果你只是想做个机器人，用 Bot API；想自己造一个 Telegram 客户端，用 TDLib；想让自己的业务系统通过 Telegram 发验证码，用 Gateway API。官方说明中，Bot API 和 Telegram API 都可以免费使用。
三类 API 的分工
| API | 面向的场景 | 你需要处理什么 |
|---|---|---|
| Bot API | 把机器人接入 Telegram，用消息当交互界面 | 只需通过 HTTPS 与官方中间服务器通信，不必了解 MTProto 加密协议 |
| Telegram API / TDLib | 构建自定义 Telegram 客户端 | TDLib 负责网络、加密、本地存储，你专注界面与动画 |
| Gateway API | 企业、App 或网站用 Telegram 替代短信发验证码 | 通过 Telegram 下发授权码，用户在一个专用聊天里收到 |
Bot 是特殊账号，不需要额外手机号就能创建，代码跑在你自己的服务器上。官方在 Bot API 之上还提供 Payments API，让机器人可以接收 Telegram 用户的付款。
TDLib 是什么，能构建什么
TDLib 全称 Telegram Database Library，是给第三方开发者用的库，目标是让你不必从零写一个 Telegram 客户端。
它替你处理三件事：网络实现细节、加密、本地数据存储。省下这部分工作后，你可以把时间放在界面设计、响应式交互和动画上。
能力范围上，官方说明 TDLib 支持全部 Telegram 功能，可用于 Android、iOS、Windows、macOS、Linux 以及几乎所有其他系统。它是开源的，并且兼容几乎所有编程语言。
所以 TDLib 适合的目标是：功能完整、跨平台的自定义 Telegram 客户端，而不是轻量脚本或简单机器人。
怎么选
- 只想让程序收发消息、当接口用 → Bot API，不需要理解 MTProto。
- 想做自己的 Telegram 客户端，覆盖全部功能、多平台 → TDLib。
- 想给自己的 App 或网站降低验证码成本、提高送达速度 → Gateway API。
官方提到 Gateway API 面向 Telegram 约 10 亿月活用户，用户会在 Telegram 内的一个专用聊天里即时收到验证码消息。这是它相对传统短信的主要卖点：更低成本、更高安全性和更快的送达速度。
常见卡点
- 把 Bot API 和 Telegram API 混为一谈：前者是简化版 HTTPS 接口，由中间服务器代管加密通信；后者才是完整协议层，TDLib 属于这一侧。
- 以为做客户端要自己实现加密：TDLib 已经把加密和本地存储包掉了，重复造这部分没有收益。
- 语言或平台限制的顾虑：官方称 TDLib 开源且兼容几乎所有编程语言，覆盖主流桌面与移动系统。
具体接入方式、参数和示例代码，以 core.telegram.org 上各 API 的对应文档页为准。