API接口文档

处理流程

• 第一步：先前往网页获得API账号和API密码（联系工作人员获取）
• 第二步：访问【登录】接口获取token令牌
• 第三步：访问【获取号码】接口获得号码
• 第四步：访问【获取验证码】接口获得验证码，每15秒访问一次查询来码情况

再次使用同一号码的API流程

• 第一步：调用【指定号码】接口，返回值提示成功，则代表号码占用成功，这时候才能请求读取验证码接口
• 第二步：调用【获取验证码】接口读取验证码

异常处理

• 如果超过三分钟还没收到验证码，则号码可能欠费，调用【拉黑号码】接口，拉黑该号码，防止再次遇到影响效率

注意事项

• 登录接口获得token后，不用再继续调用该接口。不要取号一次就访问一次登录接口
• 建议第一次对接先手动去网页操作一次看看是否会使用，以防止不会用导致不来码
• 如果试了很多号码都没成功收到过验证码，非常大的概率你选错了项目名字导致的
• 选择项目名字的正确方法：先用自己号码收一条短信看模板，例如【4399】您的验证码是123456，那么在我们平台上输入项目名字就是：4399

2. 登录（用于获得token令牌）

用于获取令牌。不要每一次获取号码都访问一次此接口，获得令牌后，后续就不要再次请求。

请求参数

返回成功示例

{
    "code": 0,
    "msg": "success",
    "token": "2f05a475cc82f05a4cc82f05a475cc8"
}

返回参数说明

3. 查询余额

用于获取账户余额、最大区号数量等个人账户信息。

请求参数

返回成功示例

{
    "code": 0,
    "msg": "success",
    "money": "36.00",
    "num": 50
}

返回参数说明

4. 获取手机号

获取一个新的手机号码用于接收验证码。

请求参数

返回成功示例

{
    "code": "0",
    "msg": "成功",
    "sid": "1000",
    "shop_name": "淘宝网",
    "country_name": "cn",
    "country_code": "cn",
    "country_qu": "+86",
    "uid": null,
    "phone": "手机号",
    "sp": "移动",
    "phone_gsd": "广东"
}

返回参数说明

5. 指定手机号

当某个号码需要再次接码时，需要调用该接口进行占用，然后才能请求读取短信接口。若不先调用此接口占用，读取验证码接口会提示"你没有权限读取该号码"。

请求参数

返回成功示例

{
    "code": "0",
    "msg": "成功",
    "sid": "22563",
    "country_name": "中国",
    "country_code": "cn",
    "country_qu": "+86",
    "phone": "132548966",
    "sp": "联通",
    "phone_gsd": "上海"
}

返回参数说明

6. 获取验证码

获取指定号码收到的短信验证码。建议每15秒轮询一次。

请求参数

返回成功示例

{
    "code": "0",
    "msg": "成功",
    "sms": "【游戏】您正在申请手机注册，验证码为：5184，1440分钟内有效！",
    "yzm": "123456"
}

返回参数说明

7. 释放号码

不来码或者号码是老号可以调用此接口进行释放，但是下次获取号码还会出来。如果不想号码再分配给你请调用拉黑接口。

请求参数

返回成功示例

{
    "code": "0",
    "data": "null",
    "msg": "释放成功"
}

返回参数说明

8. 释放全部号码

释放当前账号下的全部手机号。

请求参数

返回成功示例

{
    "code": "200",
    "data": "null",
    "msg": "success"
}

返回参数说明

9. 拉黑号码

如果这个号码不符合使用要求或是不来码，不想这个号码再分配出来给你，请调用本接口拉黑。

请求参数

返回成功示例

{
    "code": "0",
    "data": "null",
    "msg": "success"
}

返回参数说明