如何批量验证用于 Telegram 注册的电话号码

本技术指南旨在介绍如何使用 TG Validator 管理 Telegram 注册的批量验证工作流，重点涵盖数据准备、速率限制管理及结果解读。

若要使用 TG Validator 批量验证用于 Telegram 注册的电话号码 CSV 文件，请确保数据采用 E.164 格式，并通过 POST /api/v1/check 端点遍历您的列表。由于该 API 为同步模式，您的客户端应用程序必须管理每分钟 200 次请求的速率限制以及 3 个并发检查的限制，以确保处理成功并准确获取状态。

准备验证数据

在处理联系人 CSV 文件时，第一步是标准化输入。TG Validator 要求所有提交的电话号码必须采用 E.164 格式。这种国际编号方案确保每个号码在全球范围内是唯一的，通常以“+”开头，后跟国家代码和用户号码。在发起 API 请求之前，将 CSV 列标准化为 E.164 格式，可以防止出现电话号码无效的错误，并确保系统能够准确检查 Telegram 的注册状态。

理解 TG Validator API 工作流

TG Validator 是一款专注于 Telegram 验证的产品，采用同步请求-响应模型。这意味着一个请求会在同一个 HTTP 响应中返回一个结果。该产品没有原生的批量上传端点；相反，您的应用程序需要读取 CSV 并为每一行发送单独的请求。 若要检查号码，请向 POST /api/v1/check 发送请求，并包含 X-API-Key 请求头和 Content-Type: application/json。JSON 正文必须包含 "service_type": "tg" 以及包含 E.164 格式号码的 "identifier"。

管理批量吞吐量与 API 限制

由于批量验证需要客户端循环，您的脚本必须遵守平台的 API 使用控制。TG Validator 对每个用户强制执行每分钟 200 次请求的速率限制和 3 个并发检查的限制。 如果您的脚本超过这些阈值，API 将返回特定的错误代码，指示已超出速率限制或所有并发槽位已被占用。因这些限制导致的拒绝请求不会被扣费，也不会产生检查结果。在 CSV 处理脚本中实现延迟或并发限制队列，可确保执行过程顺畅且不会产生不必要的错误。

解读结果与处理错误

API 会返回一个包含 code、msg 和 data 的文档化响应包。对于 Telegram 检查，data.registered 字段提供了账户存在信号。 每个检查响应还包含 id、identifier、transaction_id、status、service_type 和 charged_amount_micros。计费严格按次执行。如果检查因 JSON 正文无效、缺少 API 密钥、验证服务维护或结果未确定而失败，费用将自动退还。您可以直接在 TG Validator 仪表板中监控您的检查历史记录、使用报告和余额支出。

常见问题解答

验证时电话号码应采用什么格式？

所有电话号码必须以 E.164 格式提交，该格式以“+”开头，后跟国家代码和用户号码，确保每个号码在全球范围内是唯一的。

TG Validator 是否支持批量处理？

不支持。TG Validator 使用同步 API，即一个请求在同一个 HTTP 响应中返回一个结果。要处理 CSV，您的客户端应用程序必须遍历列表并发送单独的请求。

如果我超过了 API 速率限制会怎样？

如果您超过了每分钟 200 次请求的速率限制或 3 个并发检查的限制，API 将返回错误代码。这些基于限制的拒绝请求不会被扣费，也不会生成检查结果。