Telegram Schema

Telegram 消息与数据结构文档

数据结构概述

Telegram API 使用 JSON 格式进行数据交换。所有的 API 响应都遵循统一的数据结构规范，确保开发者能够轻松解析和处理数据。本页面展示了 Telegram 中最常用的数据结构和字段定义。

提示：所有示例都可以直接复制使用。时间戳使用 Unix 时间格式（秒）。

Message 对象

Message 对象代表一条消息，包含发送者、接收者、时间戳和消息内容等信息。

{
  "message_id": 123,
  "from": {
    "id": 123456789,
    "is_bot": false,
    "first_name": "张三",
    "username": "zhangsan",
    "language_code": "zh-hans"
  },
  "chat": {
    "id": 123456789,
    "first_name": "张三",
    "username": "zhangsan",
    "type": "private"
  },
  "date": 1692182812,
  "text": "Hello world"
}

加载中...

字段说明

字段	类型	说明
message_id	Integer	消息的唯一标识符
from	User	消息发送者信息
chat	Chat	消息所属的聊天
date	Integer	消息发送时间（Unix 时间戳）
text	String	消息文本内容

User 对象

User 对象包含 Telegram 用户的基本信息。

{
  "id": 123456789,
  "is_bot": false,
  "first_name": "张三",
  "last_name": "李四",
  "username": "zhangsan",
  "language_code": "zh-hans",
  "is_premium": true
}

字段说明

字段	类型	说明
id	Integer	用户的唯一标识符
is_bot	Boolean	是否为机器人
first_name	String	用户的名字
username	String	用户名（可选）
is_premium	Boolean	是否为 Premium 用户

Chat 对象

Chat 对象代表一个聊天会话，可以是私聊、群组或频道。

{
  "id": -1001234567890,
  "type": "supergroup",
  "title": "Telegram 中文社区",
  "username": "telegram_cn",
  "description": "Telegram 中文用户交流群",
  "photo": {
    "small_file_id": "AQADAgAT...",
    "big_file_id": "AQADAgAT..."
  },
  "permissions": {
    "can_send_messages": true,
    "can_send_media_messages": true,
    "can_send_polls": true
  }
}

加载中...

字段说明

字段	类型	说明
id	Integer	聊天的唯一标识符
type	String	聊天类型：private、group、supergroup、channel
title	String	群组或频道标题
username	String	公开群组或频道的用户名
permissions	Object	聊天权限设置

Update 对象

Update 对象包含机器人接收到的更新信息，如新消息、编辑的消息等。

{
  "update_id": 123456789,
  "message": {
    "message_id": 123,
    "from": {
      "id": 123456789,
      "first_name": "张三"
    },
    "chat": {
      "id": 123456789,
      "type": "private"
    },
    "date": 1692182812,
    "text": "Hello from Telegram!"
  }
}

加载中...

字段说明

字段	类型	说明
update_id	Integer	更新的唯一标识符
message	Message	新接收到的消息（可选）
edited_message	Message	编辑后的消息（可选）
callback_query	Object	按钮回调查询（可选）

Telegram Schema

数据结构概述

Message 对象

字段说明

User 对象

字段说明

Chat 对象

字段说明

Update 对象

字段说明

更多数据结构