开发文档

Telegram 礼物、拍卖与收藏品

区分普通礼物、收藏礼物、拍卖状态和 Fragment 用户名,准确展示所有权与交易动作。

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

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

本页内容
  1. 礼物有不同生命周期
  2. 拍卖状态需要持续同步
  3. 用户名与收藏品所有权
  4. 实现建议

礼物有不同生命周期

可购买、已售罄但有转售、已收到、可升级及可转移等状态不能合并。列表分页与属性筛选也有独立缓存语义;需要读取当前对象的资格和限制。

拍卖状态需要持续同步

拍卖信息包括礼物、整体拍卖状态和当前用户状态。部分查询会订阅有时限的更新,版本未变化不等于订阅可以永久保留。出价、获胜与返还也应分别显示。

用户名与收藏品所有权

收藏用户名可以关联账号、Bot、群组或频道,并有启用与排序状态。显示名不等于用户名,用户名启用也不等于正在出售。手机号收藏品是另一类能力,不应当作任意手机号码的购买或注册接口。

实现建议

对每项写操作展示资产、费用和接收对象,提交后核对交易结果。跳转外部平台前展示真实域名,不根据聊天文本自动转账。对价格和所有权只描述当前查询证据,不承诺增值或固定退出收益。