手机验证码自动接收(y码)系统API说明

手机验证码自动接收（y码）系统API说明

接口地址： /http.aspx?action=

接口统一编码：UTF-8

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

接口调用时间间隔： 50毫秒。如果低于50毫秒会提示 "message|please try again later"

GET调用方法：/http.aspx?action=方法名&参数1=值&参数

2=值（具体方法名及参数请参考接口方法）

注意：

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

max_count_disable出现这个提示是因为您获取的号码以达到上限，每个获取到的号码都必须正确处理(要么调用ReleaseMobile释放号码退出任务，要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑。getRecvingInfo方法可以查看您当前获取的手机号码

如果接口返回action_parameter_error 表示传入方法名错误或方法不存在。

[方法名] loginIn

传入参数：

1. uid:用户名

2. pwd:密码

GET方式调用实例：/http.aspx?action=loginIn&uid=用户名&pwd=密码

方法调用返回值示例：

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

2. 失败返回值说明：

返回值说明

login_error 用户名密码错误

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

account_is_locked 账号被锁定

login_error 用户名密码错误

[方法名] getUserInfos

传入参数：

1. uid=用户名

2. token=登录时返回的令牌

GET方式调用实例：

/http.aspx?action=getUserInfos&uid=用户名

&token=登录时返回的令牌

方法调用返回值示例：

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

2. 失败返回值说明

返回值说明

parameter_error 传入参数错误

not_login 没有登录,在没有登录下去访问需要登录的资源，忘记传入u message|please try again later 访问速度过快，建议休眠50毫秒后再试

account_is_locked 账号被锁定

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

[方法名] getMobilenum

说明：项目ID请登录Y码官网，查看项目管理获得

传入参数：

1. pid=项目ID

2. uid=登录用户名

3. token=登录时返回的令牌

4. lock=是否锁定号码(可以不填写该参数，"1"为锁定。同一个号码接多条短信

以上可锁定，以便用已获取的号码来重复接收短信)

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

6. mobile=指定号码获取(可以不填写该参数)

7. cr=指定运营商（1:电信 2:移动 3:联通） (可以不填写该参数)

GET方式调用实例：

/http.aspx?action=getMobilenum&pid=项目

ID&uid=用户名&token=&size=1

方法调用返回值示例：

1.成功返回：手机号码|token 注意：多个号码返回值：手机号;手机号;手机号|

token

2. 失败返回值说明：

返回值说明

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

max_count_disable 已达到用户可获取号码上限，可通过调用ReleaseMobile方parameter_error 传入参数错误

not_login 没有登录,在没有登录下去访问需要登录的资源，忘记传入u message|please try again later 访问速度过快，建议休眠50毫秒后再试

account_is_locked 账号被锁定

mobile_notexists 指定的号码不存在

mobile_busy 指定的号码繁忙

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

[方法名] ReleaseMobile

说明：此方法可以释放用户获取的所有号码，并终止进行中的任务

传入参数：

1. uid=用户名

2. token=登录时返回的令牌

3. mobile=已获取到的手机号（仅限单个号码），可不填，不填就释放所有号码

GET方式调用实例：

/http.aspx?action=ReleaseMobile&uid=用户名

&token=登录时返回的令牌

方法调用返回值示例：

1.成功返回：OK

2. 失败返回值说明

返回值说明

parameter_error 传入参数错误

not_login 没有登录,在没有登录下去访问需要登录的资源，忘记传入u message|please try again later 访问速度过快，建议休眠50毫秒后再试

account_is_locked 账号被锁定

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

[方法名]getVcodeAndReleaseMobile

说明：

1.使用该方法获得验证码后，系统自动加黑该号码

2. 因部分短信可能延迟，所以建议该方法每5秒调用一次，调用100秒（可增

加获取成功率）

传入参数：

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