OPEN API

接码与虚拟卡接口文档

通过后台生成接口密钥后，即可使用开放接口获取手机号、轮询验证码、更换手机号和兑换虚拟卡。

接口入口 /api.php?action=接口名 请求方式统一使用 POST，数据格式为 JSON。
AUTH

接口鉴权

所有开放接口都需要携带有效 API 密钥。密钥可在后台“设置 / API 密钥”中生成、启用或禁用。

X-API-Key: 你的接口密钥

也兼容 query 参数：?api_key=你的接口密钥，但更推荐请求头方式。

POST

获取手机号

给接码卡密分配一个可用手机号。如果该卡密已经绑定手机号，会继续返回原手机号。

/api.php?action=open_get_phone

请求 JSON

{
  "code": "接码卡密"
}

成功返回

{
  "ok": true,
  "phone": "+11234567890",
  "remaining": 1
}
POST

获取验证码

获取当前手机号收到的验证码。没有短信时接口会返回失败信息，调用方可每 1-3 秒轮询一次。

/api.php?action=open_get_sms

请求 JSON

{
  "code": "接码卡密"
}

成功返回

{
  "ok": true,
  "sms": "Your code is 123456",
  "code": "123456",
  "remaining": 0
}

收到验证码后，该接码卡密会标记为已使用，手机号自动回库。

POST

更换手机号

释放当前绑定手机号，并让卡密回到可重新获取手机号的状态。客户手动换号时调用。

/api.php?action=open_change_phone

请求 JSON

{
  "code": "接码卡密"
}

成功返回

{
  "ok": true
}
POST

兑换虚拟卡

使用虚拟卡兑换码获取卡号、有效期、CVV、姓名和地址。已兑换且未过期时会返回已保存的结果。

/api.php?action=open_virtual_redeem

请求 JSON

{
  "redeemCode": "虚拟卡兑换码"
}

成功返回

{
  "ok": true,
  "data": {
    "cardNumber": "4111111111111111",
    "expiry": "12/29",
    "cvv": "123",
    "name": "NAME",
    "address": "ADDRESS"
  },
  "expiresAt": 1799999999
}
INFO

常见返回状态

200请求成功，返回 ok:true
400参数错误、卡密不可用、暂无验证码
403接口密钥无效或已禁用
409手机号状态变化，请重新获取手机号
502上游接口暂时无返回或格式异常