验证方法
TG Validator 如何验证 Telegram 号码
TG Validator 接收一个 E.164 手机号和 service_type=tg，同步返回 Telegram 注册状态。本页说明请求生命周期、扣费与退款条件、可重试状态，以及注册结果能够和不能够证明什么。
审核日期：2026 年 7 月 21 日
一次 Telegram 检测会经历什么？
系统先校验请求，预留 tg 产品当前费用，再对一个规范号码发起同步检测，并在同一个 HTTP 响应中返回结果。已完成的 true/false 注册结果会完成扣费；失败、超时或无判定会退回余额，并保持为未分类状态。
从号码输入到结果的请求流程
网页后台与 REST API 共用同一验证服务、响应 envelope、余额、限速和并发规则。
- 1
规范化号码
提交一个带国家区号的 E.164 手机号；无效字段会在验证前被拒绝。
- 2
使用 service_type=tg
tg 产品只回答一个明确问题：该号码在请求时是否注册 Telegram。
- 3
预留余额并同步执行
调用前预留产品费用，调用方等待同一个 HTTP 响应，不需要轮询任务或接收 webhook。
- 4
确认扣费或退款
已完成注册判断会完成扣费；失败或无判定会退回预留余额，最终扣费为零。
注册结果与控制响应
临时技术状态不是 Telegram 注册判断；消费 data.registered 前必须先理解响应码。
| 状态 | 含义 | 建议动作 |
|---|---|---|
| 完成 · registered=true | 本次检测报告号码在请求时已注册 Telegram。 | 保存结果与检测时间。 |
| 完成 · registered=false | 本次检测报告号码当时未注册。 | 与输入错误和服务失败分开保存。 |
| 400 | 请求体、service_type 或号码无效。 | 修正输入后再试。 |
| 402 | 账号余额不足。 | 充值后重试；当前没有注册结论。 |
| 429 | 达到用户限速或并发上限。 | 退避并将多余任务排队。 |
| 503 或无判定 | 没有产生可用判断。 | 稍后重试，绝不能转换为 false。 |
扣费、限流与重试属于同一个契约
后台与 API 共用余额和用户级控制，避免两个入口绕过发布的使用限制。
- 只有已完成检测会保留扣费；失败和无判定自动退款。
- 每个用户最多同时执行 3 个检测。
- 网页后台与 API 合计限制为每分钟 200 次请求。
- 收到 429 后等待；再次受限时逐步延长等待时间。
- 收到 503 时保留待处理记录并稍后重试。
结果不能证明什么
注册状态是一个时点的数据质量信号，不提供 Telegram 私密内容，也不能产生触达所需的合法依据。
- 不能识别号码由哪个个人控制。
- 不会返回消息、聊天、群组、联系人、活跃度或最近在线信息。
- 不能保证消息送达或未来仍保持注册。
- 不能授予联系同意，也不能覆盖接收方偏好。