名称相似 处理方式不同
FLOOD_WAIT 和 API_ID_PUBLISHED_FLOOD 常出现在软件使用 API 的过程中。已经申请成功后看到这些错误,不能直接认定门户申请未完成。
先保留错误名称和返回的等待数字,避免只截掉中间部分发一句“又 ERROR 了”。日志中出现的完整凭证和用户信息应遮挡。
FLOOD_WAIT 应按返回时间等待
Telegram 官方说明,FLOOD_WAIT_X 中的数字表示需要等待的秒数。例如返回值包含 120,表示等待 120 秒;这只是解释示例,不是固定限制。官方错误处理文档
调用程序应暂停受限操作,避免多个任务在等待期间继续重复请求。等待结束后也应控制调用频率,而不是立即补发大量积压请求。
换一套 API 或重复申请并不是处理调用过快的默认方法。若程序始终无节制地重试,应先修复程序的等待和重试安排。
API_ID_PUBLISHED_FLOOD 要核对凭证来源
官方发码接口将这一错误与已经公开而无法继续使用的 API ID 关联。官方也提醒,源码中的示例 ID 不适合用于面向用户发布的应用。auth.sendCode 错误列表、应用 ID 使用说明
因此应先确认程序是否仍使用教程中的样例值、公开共享配置或他人提供的凭证。面向自己的应用时,按官方要求使用自行取得的应用资料。
如果确认当前用的是自己的资料,仍然返回这一错误,不要猜测“重新读取一次就能解除”。保存脱敏的错误上下文,按 Telegram 官方支持渠道反馈实际情况。
与门户 Too many tries 的区别
门户网页上的频繁尝试提示,并不一定提供 FLOOD_WAIT_X 这种精确数字。不能把一段客户端日志的等待规则,当作所有网页申请失败的恢复期限。
如果你还停留在门户验证阶段,直接阅读 Too many tries 处理。若已经完成申请,就检查产生错误的具体软件。
什么时候需要申请协助
你尚未持有自己应用的 ID 与 Hash,或需要读取已存在的应用资料时,可以 通过 GetTGAPI 咨询代申请,再 使用授权码办理。
平台协助申请流程,不提供解除调用限制、封禁或绕过等待的服务。最终应分别确认应用资料已取得、软件配置已生效,以及受限操作已按规则恢复。