TGValidator

API 文档

面向单号检测的 Telegram 验证 API

选择 service_type，提交一个手机号，即可同步获得对应产品的结果。

API 速览一个同步接口，一个 service_type，以及统一的 code / msg / data 响应结构。

认证

使用在设置中创建的 API Key，并随每次请求一起发送。

X-API-Key: wac_your_api_key

单次检测

POST /api/v1/check
service_typetg
identifier带国家码的 E.164 手机号

请求体

{
  "service_type": "ws",
  "identifier": "+14155552671"
}

产品与返回字段

tgTelegram 注册检测确认手机号是否已注册 Telegram。
1 积分

avatar=false and business=false 仅用于兼容统一响应模型。判断注册状态始终使用 registered 字段。

响应示例

每次检测都会返回统一的 code / msg / data 结构，data 字段展示 Telegram 注册检测结果。

tgTelegram 注册检测1 积分
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 123,
    "identifier": "+14155552671",
    "registered": true,
    "transaction_id": "chk_example123",
    "status": "success",
    "service_type": "tg",
    "charged_credits": 1
  }
}

错误码

40000不支持的 service_type 或字段冲突
40001JSON 请求体无效
40002手机号无效
40100缺少或无效的 API Key
40200积分不足
42900超出速率限制
50300检测服务维护中

cURL 示例

export WA_CHECKER_API_BASE="https://your-api-domain.com"

curl -X POST "$WA_CHECKER_API_BASE/api/v1/check" \
  -H "X-API-Key: wac_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws", "identifier": "+14155552671" }'

将 WA_CHECKER_API_BASE 替换为实际 API 基础地址。

创建免费账号