Developer · 開發者文件

Telegram MTProto API · 開發者必讀

若你想開發 Telegram 第三方客戶端、機器人或自動化工具,MTProto API 是最底層的入口。

Telegram 對開發者開放兩種 API:Bot API(HTTPS 介面,限機器人使用)與 MTProto API(協議層介面,可實作完整客戶端功能)。前者簡單但受限——例如無法操作普通使用者帳號、無法主動加群、檔案大小限 50MB;後者強大但複雜,需理解 TL 序列化格式與 Diffie-Hellman 金鑰交換流程。

MTProto API 能做什麼

透過 MTProto API,開發者可建立完整的 Telegram 客戶端:登入帳號、收發訊息、管理頻道、上傳大型檔案(最大 4GB)、發起語音通話皆無不可。當下知名的第三方實作包括 Pyrogram(Python,1.4 萬 stars)、Telethon(Python,1 萬 stars)、gramjs(Node.js)、TDLib(官方 C++ 函式庫,21k stars)。Pyrogram 因 API 設計優雅而受 Python 開發者愛戴,Telethon 則因歷史較久、文件詳盡而適合教學。

申請與使用

使用 MTProto API 需先於 my.telegram.org 申請 api_idapi_hash。Telegram 對 API 使用設有速率限制:每秒最多 30 次訊息發送、每分鐘最多 20 次群組加入。自動化操作須遵循其服務條款,否則帳號可能遭限制甚至封禁。官方文件位於 core.telegram.org/mtproto

參考資料 · References

  1. Pyrogram 官方文件
  2. Telethon 官方文件
  3. MTProto API 規範
立即取一條 Telegram 代理 本站每三小時更新,目錄中皆為驗證可達之 MTProto 入口。
前往代理目錄