准备用于批量电话号码检查的 CSV 或 TXT 文件

本文是一份技术工作流指南，旨在说明如何使用同步 API 准备和处理批量电话号码检查的 CSV 或 TXT 文件，重点介绍了 E.164 格式规范及速率限制管理。

若要使用 TG Validator 处理用于 Telegram 注册验证的批量电话号码检查 CSV 或 TXT 文件，必须将所有号码格式化为 E.164 标准。由于该平台作为同步的单标识符 API 运行，因此批量列表需通过在客户端遍历文件来进行处理。您的实现方案必须管理请求流，以遵守每分钟 200 次请求的速率限制和 3 个并发检查的限制。每个成功的请求都会返回一个账户存在信号，指示检查时的 Telegram 注册状态。

准备用于验证的数据

在准备用于验证的 CSV 或 TXT 文件时，每个电话号码都必须符合 E.164 标准。该国际编号计划要求在国家代码和用户号码前加上加号（+）。TG Validator 严格要求所有输入项均采用 E.164 格式。确保您的列表在发起检查前符合此标准，有助于准确处理并避免无效电话号码错误。

理解同步工作流

TG Validator 是一款专注于 Telegram 验证的产品，以同步方式运行。这意味着它不支持异步批量上传或原生文件处理。相反，一个请求会在同一个 HTTP 响应中返回一个结果。若要处理批量列表，您的客户端应用程序必须读取 CSV 或 TXT 文件，并将每个号码单独提交至 POST /api/v1/check 端点。该请求需要一个 X-API-Key 标头，以及一个包含 "service_type": "tg" 和带有 E.164 号码的 "identifier" 字段的 JSON 正文。

管理 API 限制与性能

由于您是在遍历列表，您的脚本必须安全地处理 API 使用控制。公共 API 对每个用户强制执行每分钟 200 次请求的速率限制和 3 个并发检查的限制。如果您的脚本超过这些阈值，API 将返回特定的错误代码，提示速率限制已超限或所有并发槽位已满。因速率和并发限制导致的拒绝请求不会计费，也不会产生检查结果。在客户端实施限流和重试逻辑，有助于将批量处理保持在这些记录的边界内。计费按次进行，任何失败或未确定的检查都会自动退款。

解读注册结果

每次成功的检查都会返回一个记录在案的代码、消息和数据响应包。对于 Telegram 检查，service_type=tg 请求会在 data.registered 字段中返回注册状态。此结果仅作为检查时的账户存在信号。您可以通过 TG Validator 仪表板监控整体处理进度、检查历史记录和余额消耗，该仪表板支持使用情况报告和 7 天趋势分析。

常见问题解答

我的电话号码应该采用什么格式？

所有电话号码必须以 E.164 格式提交，即包含加号、国家代码和用户号码。

TG Validator 支持批量文件上传吗？

不支持。该平台作为同步 API 运行，一个请求在同一个 HTTP 响应中返回一个结果。批量列表必须通过在客户端提交单独请求的方式进行处理。

注册状态实际上意味着什么？

注册结果报告的是检查时的 Telegram 注册状态。

我该如何处理速率限制错误？

您的客户端实现应遵守每分钟 200 次请求的速率限制和 3 个并发检查的限制。因超出这些限制而被拒绝的请求不会计费，也不会产生检查结果。