墨西哥实时数据综合 API查询 Telcel 账户
GET
/telcel/account-20%0.4 USDT/次0.32 USDT/次免费计费说明：发生异常时不收取费用。
空结果计费说明：该接口每天最多提供 10 次免费空结果查询。
空结果定义：服务器查询结果为空，未找到任何数据。
查询所提供 10 位手机号码对应的 Telcel/ClaroPay 账户状态。返回用户是否已在 Telcel 应用中绑定银行卡，以及是否已完成 N2 级身份验证；根据墨西哥金融监管要求，启用支付和绑卡功能前必须完成该验证。
以下为完整的合成示例数据。请使用您有权查询的数据进行在线测试；在线测试显示接口实际返回结果。
开始使用这个接口
- 注册账号，或使用已有账号。
- 在「账号 → 安全」中复制 API Token。
- 在「在线测试」中输入 Token 和您有权查询的原始数据。脱敏示例仅用于说明格式，实际调用时须替换。
在线测试受账号测试额度和网关规则约束。正式调用前，请确认接口单价和可用余额。 查看余额与充值
请求头参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
X-Api-Token | string | 必填 | 您的平台 API 令牌 |
参数
| 名称 | 位置 | 类型 | 是否必填 | 示例 | 描述 |
|---|---|---|---|---|---|
phone | query | string | 必填 | 0000000000 | 10-digit Telcel mobile number |
响应 200JSON
{
"data": {
"registered_cards": true,
"n2_activation": false
},
"status": 200,
"message": "Found",
"success": true
}数据来源
- 记录持有方
- Telcel — Radiomóvil Dipsa, S.A. de C.V. 官方站点
- 数据类别
- 移动账户状态
- 国家
- 墨西哥 · 商业持有方
API Pull 不持有该记录的自有副本。每次调用都转发给上述来源，并把返回内容原样传回；准确性与可用性取决于该来源。
速率限制与免费额度
- 每秒请求数上限
- 10
- 每日免费空结果次数
- 10
未命中记录的调用在此额度内不计费。超出后，空结果按单价计费。
扣费发生在调用当时。余额不足时网关返回 402，且不会发起调用。
错误码
以下是生产环境实际观测到的状态码及其处理方式。未列出的状态码尚未出现过。
| 状态码 | 含义与处理方式 |
|---|---|
200 | 请求已到达上游并有响应返回。其中包含“查无记录”的情形，因此要看载荷内容，不能只看状态码。 |
402 | 预付余额不足以支付本次调用。调用未发起，也未扣费。充值后重试。 |
504 | 上游未在时限内响应。请稍后重试；对慢速登记机构而言这是正常的失败形态。 |
404 | 路由不存在，或该接口已下线。 |
401 | API token 缺失或无效。 |
使用条件
本接口返回的是由国家登记机构或机构持有的、关于可识别个人的个人数据。你必须对查询的每一个标识符具备合法依据，不得遍历标识符区间，也不得将结果作为对他人作出不利决定的唯一依据。