把 true 视为当时状态
registered=true 表示本次检测报告该号码已注册 Telegram；它不透露账号活跃度、资料详情、号码归属或联系许可。
公开演示
POST /api/v1/checkservice_type=tgservice_type： tg
Telegram 注册检测
通过同步 API 或网页后台确认手机号是否已注册 Telegram，适合发送前检查联系人名单。
响应方式: 同步API 接口:
/api/v1/check
Telegram 注册检测公开演示
无需登录；公开演示有每日次数限制。
结果解释
Telegram 注册检测结果代表什么？
一次完成的 tg 检测会报告所提交的 E.164 号码在请求时是否注册 Telegram。请把 registered 与失败或无判定请求分开理解：只有完成的检测才会给出可用的 true 或 false；业务需要更晚状态时，应重新检测。
区分 false 与请求错误
registered=false 是一个已完成结果；失败或无判定属于不同结果，并会退款，而不会被当作未注册。
用于分流，不用于身份认定
可用注册状态清洗或分流联系人记录，但不能将其视为号码背后个人或组织的身份证明。
正确使用结果
让一次单号码检测真正有用的三个细节
提交一个 E.164 号码
请包含国家区号，例如 +14155552671，确保每次请求对应一个明确的号码。
读取 data.registered
tg 服务在网页后台和 API 的相同同步响应结构中返回 Telegram 注册状态。
使用同步返回结果
后端会同步返回 data.registered；需要更新状态时请重新检测，联系用户前仍需取得相应同意。
API 契约
一次请求，立即返回
提交一个 E.164 手机号，并用 service_type 选择本产品；认证使用你的 API Key。
请求
POST /api/v1/check{
"service_type": "tg",
"identifier": "+14155552671"
}响应
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "tg",
"identifier": "+14155552671",
"registered": true
}
}检测内容
Telegram 注册检测 会返回什么？
Telegram 注册检测可确认手机号是否已注册 Telegram，适合群发、线索分配或触达前校验。
适用场景
在以下场景使用本产品
- 联系人名单检查
- 线索筛选
- 发送前校验
- CRM 数据质量
直接答案
注册检测 是什么？
Telegram 注册检测 是一个返回注册状态的 service_type。调用时把 service_type 设为 tg，并提交一个 E.164 格式手机号，即可在同一次 API 响应中获得结果，并保存后台检测记录。仅在检测完成后扣除余额；失败或无判定检测会自动退回余额。
能力边界
不会返回哪些内容
- 不会返回 Telegram 消息、聊天、群组或任何私密账号内容。
- 不会返回在线状态、最后上线时间或实时活跃情况。
- 只返回 tg 响应中定义的注册状态字段。
产品常见问题
关于注册检测的常见问题
Telegram 注册检测 检测什么？
它对一个手机号进行检测，并在同一次同步响应中返回注册状态。
注册检测如何计费？
仅在检测完成后扣除余额；上游失败或无判定的请求不会保留扣费。
需要什么手机号格式？
请使用带国家码的 E.164 格式，例如 +14155552671。
显示已注册，是否代表获得了联系许可？
不是。结果仅反映检测时的 Telegram 注册状态；同意、接收方偏好和适用的平台规则仍需由您自行遵守。