结果指南
如何解读 Telegram 验证结果
TG Validator 将已完成的 Telegram 注册判断与输入错误、限流、余额不足和临时失败分开。可靠的集成不会把所有非 true 响应都简化成 false。
审核日期：2026 年 7 月 21 日
registered 代表什么？
registered=true 表示一次已完成的 tg 检测报告该 E.164 号码在请求时已注册 Telegram；registered=false 表示已完成检测报告当时未注册。超时、429、503 或无判定没有 true/false 结论，应保持待纠错或重试。
读取 data.registered 前先分类响应
响应 envelope 说明是否存在可用注册结果；临时控制状态不得覆盖最近一次有效状态。
| 响应 | 分类 | 建议保存方式 |
|---|---|---|
| 成功 + registered=true | 已完成且已注册 | true + 检测时间 |
| 成功 + registered=false | 已完成且未注册 | false + 检测时间 |
| 400 | 请求体、service_type 或号码无效 | 输入错误，需要修正 |
| 402 | 余额不足 | 计费阻断，不存在注册结论 |
| 429 | 限速或并发上限 | 可重试控制状态 |
| 503 或无判定 | 临时服务结果 | 待处理/重试，不能写 false |
使用三态业务模型
已注册、未注册与待处理存在实质差异。将它们分开可避免服务异常和脏数据错误抑制有效联系人。
- 1
已完成且已注册
保存 true、service_type=tg 与检测时间。
- 2
已完成且未注册
保存 false 与相同审计字段，不与输入错误合并。
- 3
待处理或可重试
用于 429、503、超时与无判定，同时保留已有有效状态。
- 4
输入被拒绝
将无效号码或请求错误返回规范化流程。
决定何时重新检测
注册状态是时点数据。复核周期取决于业务用途和过期判断的成本。
- 每个完成结果都保存 verified_at。
- 临时失败不得静默替换已有有效状态。
- 时效性路由应按自身政策判断旧结果是否需要复检。
- 没有业务决策需要新状态时，不要持续轮询。
响应范围之外的结论
tg 产品只报告注册状态，不提供私密账号内容或联系许可。
- 不能识别号码所有者。
- 不会返回消息、聊天、群组、联系人、活跃度或最近在线。
- 不能保证未来注册状态或消息送达。
- 不能授予联系该号码的同意。