Telegram API

开放的 API 接口,助力开发者构建强大的 Telegram 应用

API 概览

Telegram API 是完全开放的,允许开发者创建自己的客户端应用和机器人。我们提供两种主要的 API:

  • Bot API - 用于创建 Telegram 机器人的 HTTP 接口
  • TDLib (Telegram Database Library) - 用于创建自定义 Telegram 客户端的库

授权方式

使用 Telegram Bot API 需要先通过 BotFather 创建机器人并获取 API Token:

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 命令创建新机器人
  3. 按照指引设置机器人名称和用户名
  4. 获取 API Token 用于接口调用
Token 格式: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

常见接口

getUpdates

获取机器人接收到的最新消息更新

fetch('https://api.telegram.org/bot<token>/getUpdates')
  .then(response => response.json())
  .then(data => console.log(data));

sendMessage

发送文本消息到指定聊天

fetch('https://api.telegram.org/bot<token>/sendMessage', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    chat_id: 'CHAT_ID',
    text: 'Hello from Telegram Bot!'
  })
});

getChat

获取聊天信息

fetch('https://api.telegram.org/bot<token>/getChat?chat_id=CHAT_ID')
  .then(response => response.json())
  .then(data => console.log(data));

开发者资源

访问 Telegram 官方文档获取完整的 API 参考和示例代码。我们的开发者社区随时准备帮助您解决开发过程中遇到的问题。