速码验证码平台API接口文档A版

admin管理员组

文章数量:1532708

2024年1月9日发(作者：)

速码验证码接收平台API接口A版

速码验证码平台API接口文档A版

一、统一说明

为了让开发者更快更便捷的接入速码平台，速码团队开发了A版B版两套API接口，两者并无差别，均可兼容，实现了只需更换网址即可将现有软件快速接入速码。

➢ 接口地址：/?action=

➢ 接口统一编码：UTF-8

➢ 接口调用方式： HTTP，支持GET和POST两种方式。

➢ GET方式调用实例：/?action=方法名&参数1=值&参数2=值（具体方法名及参数请参考接口方法）。

软件开发者说明：

服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，速码平台是不定时加号的。

max_count_disable出现这个提示是因为您获取的号码没有正常处理，每个获取到的号码都必须正确处理(要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑。getRecvingInfo方法可以查看您当前获取的手机号码 如果接口返回action_parameter_error

表示传入方法名错误或方法不存在。

1 / 13

速码验证码接收平台API接口A版

软件作者账号无需另外注册，在获取验证码方法中上传一个速码账号即可获得分成。若该分成账号在平台消费，则会优先消费获得的分成金额。

二、接口方法

1、用户登录

1）方法名：loginIn

2）传入参数：

➢ uid:用户名：

➢ pwd:密码

3）GET方式调用实例：

➢ /?action=loginIn&uid=用户名&pwd=密码

4）方法调用返回值示例：

1））成功返回：用户名|token(下面所有方法都要用的令牌)

2））失败返回值&说明：

➢ login_error用户名密码错误

2 / 13

速码验证码接收平台API接口A版

➢ message|速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ account_is_FreezeUser账号被冻结

2、获取用户个人信息

1）方法名：getUserInfos

2）传入参数：

➢ uid:用户名

➢ token=登录时返回的令牌

3）GET方式调用实例：

➢ /?action=getUserInfos&uid=用户名&token=登录时返回的令牌

4）方法调用返回值示例：

1））成功返回：用户名;积分;余额;可同时获取号码数

2））失败返回值&说明：

3 / 13

速码验证码接收平台API接口A版

➢ parameter_error传入参数错误

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ message|please try again later访问速度过快，建议休眠50毫秒后再试

➢ unknow_error未知错误,再次请求就会正确返回

3、获取手机号码

1）方法名：getMobilenum

2）传入参数：

➢ pid=项目ID

➢ uid=登录用户名

➢ token=登录时返回的令牌

➢ mobile=指定号码获取(可以不填写该参数，如填入格式不正确则获取新号码)

➢ size=获取号码数(可以不填，默认为1，1<=size<=10)

4 / 13

速码验证码接收平台API接口A版

➢ province=归属地（省份，例如：广东、北京）

➢ province值：广东|辽宁|湖南|内蒙古|浙江|安徽|贵州|西藏|黑龙江|陕西|广西|湖北|福建|山西|江西|海南|江苏|云南|河南|山东|新疆|青海|吉林|河北|宁夏|北京|天津|上海|四川|重庆|甘肃

➢ province中文传参时可能产生乱码，最好经过URL转码,（例如：java转码方式 ("广东","UTF-8")）。

➢ phoneType=运营商（CMCC（移动）、UNICOM（联通）、TELECOM（电信）） 。

3）GET方式调用实例：

➢ /?action=getMobilenum&pid=项目ID&uid=用户名&token=登录时返回的令牌&mobile=&size=1

4）归属地、运营商调用实例：

➢ /?action=getMobilenum&pid=项目ID&uid=用户名&token=登录时返回的令牌&mobile=&size=1&province=广东&phoneType=CMCC

5）方法调用返回值示例：

5 / 13

速码验证码接收平台API接口A版

1））成功返回：手机号码|token

注意：多个号码返回值：手机号;手机号;手机号| token

2））失败返回值&说明：

➢ no_data系统暂时没有可用号码了

➢ parameter_error传入参数错误

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ message|速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试

➢ not_found_project没有找到项目,项目ID不正确

➢ message|可使用余额不足可使用余额不足

➢ max_count_disable已经达到了当前等级可以获取手机号的最大数量，请先处理完您手上的号码再获取新的号码（处 6 / 13

速码验证码接收平台API接口A版

理方式：能用的号码就获取验证码，不能用的号码就加黑）

➢ unknow_error未知错误,再次请求就会正确返回

4、获取验证码并不再使用本号

1）方法名：getVcodeAndReleaseMobile

2）传入参数：

➢ mobile=用getMobilenum方法获取到的手机号

➢ token=登录时返回的令牌

➢ uid=用户名

➢ author_uid=软件开发者用户名(可选, 可得10%的消费分成)

3）GET方式调用实例：

➢ /?action=getVcodeAndReleaseMobile&uid=用户名&token=登录时返回的令牌&mobile=获取到的手机号码&author_uid=软件开发者用户名(可选, 可得10%的消费分成)

4）方法调用返回值示例：

1））成功返回：手机号码|验证码短信

7 / 13

速码验证码接收平台API接口A版

2））失败返回值&说明：

➢ not_receive还没有接收到验证码,请让程序等待几秒后再次尝试

➢ parameter_error传入参数错误

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ message|please try again later访问速度过快，建议休眠50毫秒后再试

➢ message|可使用余额不足可使用余额不足

➢ not_found_moblie没有找到手机号

➢ not_found_project没有找到项目,项目ID不正确

5、获取验证码并继续使用本号

1）方法名：getVcodeAndHoldMobilenum

2）传入参数：

➢ mobile=用getMobilenum方法获取到的手机号

8 / 13

速码验证码接收平台API接口A版

➢ uid=用户名

➢ token=登录时返回的令牌

➢ next_pid=下个要接收的项目ID

➢ author_uid=软件开发者用户名(可选, 可得10%的消费分成)

3）GET方式调用实例：

➢ /?action=getVcodeAndHoldMobilenum&uid=用户&token=登录时返回的令牌&mobile=获取到的手机号码&next_pid=下个要接收的项目ID&author_uid=软件开发者用户名(可选, 可得10%的消费分成)

4）方法调用返回值示例：

1））成功返回：发送号码|验证码| token

2））失败返回值&说明：

➢ not_receive还没有接收到验证码,请让程序等待几秒后再次尝试

➢ parameter_error传入参数错误

9 / 13

速码验证码接收平台API接口A版

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ message|please try again later访问速度过快，建议休眠50毫秒后再试

➢ message|可使用余额不足可使用余额不足

➢ not_found_moblie没有找到手机号

➢ not_found_project没有找到项目,项目ID不正确

➢ unknow_error未知错误,再次请求就会正确返回

6、加黑无用号码

1）方法名：addIgnoreList

2）传入参数：

➢ pid=项目ID

➢ mobiles=以,号分隔的手机号列表

➢ uid=用户名

➢ token=登录时返回的令牌

10 / 13

速码验证码接收平台API接口A版

3）GET方式调用实例：

➢ /?action=addIgnoreList&uid=用户名&token=登录时返回的令牌&mobiles=号码1,号码2,号码3&pid=项目ID

4）方法调用返回值示例：

1））成功返回：加黑成功的号码数量

2））失败返回值&说明：

➢ parameter_error传入参数错误

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ unknow_error未知错误,再次请求就会正确返回

7、已获取号码列表

1）方法名：getRecvingInfo

11 / 13

速码验证码接收平台API接口A版

2）传入参数：

➢ uid=用户名

➢ token=登录时返回的令牌

➢ pid=项目ID（pid等于0的时候获取所有号码，pid不等于0的时候获取指定项目号码）

3）GET方式调用实例：

➢ /?action=getRecvingInfo&uid=用户名&pid=项目ID&token=登录时返回的令牌

4）方法调用返回值示例：

1））成功返回： 没有获取号码记录:[ ] 单条：[{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间}]（*"Timeout"以秒为单位）

多条：[{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间},{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间},{...}]（*"Timeout"以秒为单位）

2））失败返回值说明：

12 / 13

速码验证码接收平台API接口A版

➢ parameter_error传入参数错误

➢ not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token

➢ account_is_locked账号被锁定

➢ account_is_stoped账号被停用

➢ account_is_question_locked账号已关闭

➢ account_is_ip_stoped账号ip锁定

➢ message|please try again later访问速度过快，建议休眠100毫秒后再试

➢ not_found_moblie没有找到手机号

➢ not_found_project没有找到项目,项目ID不正确

➢ message|可使用余额不足可使用余额不足

➢ not_send号码已下线，无法发送

➢ fail失败

➢ unknow_error未知错误,再次请求就会正确返回

13 / 13

本文标签： 号码验证码获取登录