开发文档

Telegram Peer 数据库、access_hash 与 min 对象

理解用户、群组和频道身份,以及 access_hash 和精简对象的使用边界,避免错误缓存和跨账号复用。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. ID 与可用的访问凭据并不相同
  2. min 不能覆盖成完整对象
  3. 缓存设计建议

ID 与可用的访问凭据并不相同

用户、群组和频道统称 peer。接收对象时需要维护本地信息,许多后续调用还需要 access_hash。它既不是 API Hash,也不应被当作公开、跨账号通用的标识。

完整对象、扩展信息和各类局部更新有不同刷新规则。避免持续拉取没有变化的资料;以收到的对象和更新为依据维护缓存。

min 不能覆盖成完整对象

带 min 标记的 user 或 channel 只包含部分信息。合并时需要遵循对应构造器的字段例外,并保存遇到该对象的消息上下文。后续操作可能需要 inputPeerUserFromMessage 等形式,而非普通 InputPeer。

user 与 channel 的构造器页用于查字段、标志及例外,不能仅根据 ID 长度猜测对象类型。

缓存设计建议

以账号和 peer 类型共同隔离记录,明确标记数据来源与完整程度。遇到权限变化时更新能力显示,不把“知道 ID”解释为“有权读取”。测试资料改名、退出群组、精简对象晚到和账号切换,检查旧值是否被错误保留或跨账号泄露。