先确定你正在验证什么
API ID / API Hash 申请、Telegram 客户端登录和 GetTGAPI 授权码验证是三个不同流程。 看见手机号输入框,不能直接认为后面一定发送短信;拿到应用资料,也不等于登录成功。
本篇用于阅读官方授权文档,帮助分辨提示。不提供代注册或托管登录服务;开发者门户操作见 API 申请教程。
官方授权文档的关键点
官方用户授权说明描述:auth.sendCode 后按返回类型处理;auth.sentCodeTypeApp 指向已有登录会话,auth.sentCodeTypeSms 表示短信路径。还可能出现邮箱、两步密码、设备校验或付费条件。发码方式由服务端决定,第三方实现不能保证免费短信或指定通道。完整条件以原文为准。
GetTGAPI 流程对照
下面按实际用途区分各类凭证与授权流程。
| 你看到的输入或结果 | 当前应该做什么 | 不应该据此推断什么 |
|---|---|---|
| gettgapi.com 要求授权码 | 输入从本站客服或销售渠道获取的授权码 | 这不是 Telegram 登录码 |
| 申请页面要求手机号与门户确认码 | 对照本轮门户消息填写;不向客服发送码 | 不代表网站要登录你的聊天客户端 |
| 结果显示 ID 与 Hash | 自行安全保存,确认后可清除临时结果 | 不代表你已授权某个第三方客户端 |
| 其他软件要求用户登录验证 | 阅读那个客户端的说明,确认验证目标 | 不属于本站 API 申请步骤 |
不要把在一个客户端拿到的码,试填到另一个不相关流程。遇到问题时先保留页面地址和提示文字,确认是否处于同一次操作。
给自己程序设计反馈时
GetTGAPI 的实现经验是:界面应陈述已确认的状态。请求已提交、上游接受请求、用户实际收到消息、结果已验证,是不同的证据。只有得到明确的通道信息,才显示对应的收码说明;不能把“请求没有报错”写成“手机肯定已经收到短信”。
响应不明时,应保留任务上下文并先核对状态,避免连续重复操作。客户界面提供可理解的动作,管理日志保存经过脱敏的诊断依据。这里描述的是工程建议,不是对官方投递成功率的保证。
收不到门户确认码时
请从 验证码未收到指南 开始,而不是把账号注册文章当作门户排错说明。需要协助时,在 gettgapi.com/help#contact 告诉客服出错步骤与时间;不要发送验证码、两步密码或完整 API Hash。