如何实时检测一份 CSV 或 TXT 号码名单

本文是一份技术工作流指南，说明如何把 CSV 或 TXT 号码名单交给 TG Validator 实时检测 Telegram 注册状态，重点介绍 E.164 格式规范、同步单号与多号接口以及并发管理。

TG Validator 以实时检测为主：把一个 E.164 号码提交到 POST /api/v1/check，或把最多 100 个号码提交到同步多号接口 POST /api/v1/batch-check，完成结果都在同一个 HTTP 响应中返回，无需提交任务、轮询或下载。处理 CSV 或 TXT 名单时，先把所有号码格式化为 E.164，再通过多号接口按每次最多 100 个提交。远超一次实时请求的整份文件，也可以作为异步批量任务上传（上传、等待、下载）；提交任务时要选定号码所属的国家或地区，一份名单应基本属于这一个国家。

准备用于验证的数据

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

理解同步工作流

TG Validator 的主模型是同步的：单号调用 POST /api/v1/check，最多 100 个号码调用同步多号接口 POST /api/v1/batch-check，均携带 service_type=tg。两种接口都会在发起请求的同一个 HTTP 响应中返回完成结果，没有任务提交、轮询、回调或下载步骤，也没有同一国家的要求。超出多号接口上限的整份文件，另有异步批量任务（/api/v1/bulk-tasks）可用：上传名单、获得任务 id、任务完成后下载结果文件。

管理 API 限制与性能

余额与检测历史可在网页后台查看；当前计费规则请以价格页和 API 文档为准。

解读注册结果

每次成功的检查都会返回一个记录在案的代码、消息和数据响应包。对于 Telegram 检查，service_type=tg 请求会在 data.registered 字段中返回注册状态。此结果仅作为检查时的账户存在信号。您可以通过 TG Validator 仪表板查看检查历史记录、余额消耗、使用报告和账户活动。

常见问题解答

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

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

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

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

我该如何处理并发拒绝？

您的客户端实现应遵守 API 文档中说明的并发限制。因超出这些限制而被拒绝的请求不会计费，也不会产生检查结果。

检测一份名单必须上传文件吗？

不必。实时路径才是主路径：单号用 POST /api/v1/check，最多 100 个号码用同步多号接口 POST /api/v1/batch-check，结果在同一次响应中返回。整份大名单另有异步批量任务作为补充（上传、等待、下载；提交时选定号码所属国家，一份名单应基本属于这一个国家）。日常检测直接走同步接口即可。