自动化API

API

方便开发，自动接收短信API

示例代码下载

自动接收短信API

系统可提供自动化API供开发者开发自动化程序。如有不明白之处或自己没能力开发程序想找人开发的请加飞QAPI开发者交流群:159433030.无类似需求勿加.

下面是系统API的说明

地址： http://sms.xudan123.com/do.aspx

编码:UTF-8

统一参数调用方法

posturl: http://sms.xudan123.com/do.aspx

post数据:action=方法名&参数名1=值1....

如登录调用方法：

posturl: http://sms.xudan123.com/do.aspx

post数据:action=loginIn&uid=用户名&pwd=密码

 

所有API统一返回值含意

1:正常

unknow_error:未知错误,如果在获取号码或获取验证码时返回则再次请求就会正确返回.

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

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

not_found_moblie:没有找到手机号

login_error:用户名密码错误

mobile_exists:手机号己存在

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

parameter_error:传入参数错误

no_data:没有数据

project_state_error:项目状态不对,可能项目还没通过审核

mobile_state_error:手机号状态不对,立即放弃该号码，调用getMobilenum获取新的号码，不用加黑

max_count_disable:已经达到了可以获取手机号的最大数量，不要随便调用cancelSMSRecvAll释放,否则之前获取的所有号码将会失效.
此处应当考虑到户用积分不足的情况,如果调用了cancelSMSRecvAll程序会进入死循环,会一直重复获取号码然后遇到max_count_disable然后cancelSMSRecvAll然后再重复以上过程.

 

注意：

服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，没号了系统有监控会及时加号的。

系统限制同一个IP每秒只接受一次获取号码请求,如果同一秒有多次则其中一个请求将返回"message|please try again later",遇到这个请延迟当前线程500毫秒以上再次获取号码.

在发送短信完成后最好等待10秒再开始获取验证码，因为就算是正常手机接短信也是需要大概10秒时间的，如果服务器返回not_receive最好等待5秒后再次请求。

当然你可以根据自己的意愿自行设定发完短信等待时间和请求验证码间隔。最好不要一秒内请求一次或几次,否则有可能服务器会暂时封锁当前IP.

每个获取到的号码都必须正确处理(要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑，要么释放所有号码)，否则号码超时后系统会把你的获取号码数量惩罚值+1，这将导致你的可同时获取的号码数量减少。

在多线程程序中不要调用cancelSMSRecvAll,否则会影响其他线程的接收.调了cancelSMSRecvAll会释放当前用户下所有已经获取到的号码。

[方法] loginIn 登录

接收参数：uid:用户名,pwd:密码

返回值：uid:当前登录用户名,token:下面所有方法都要用的令牌

备注：无

[方法] getMobilenum 获取一个手机号

接收参数：pid=项目ID,uid=登录用户名,token=登录时返回的令牌

返回值：手机号|下次获取验证码的token(暂时无用)

备注：返回值以|号分隔

[方法] getVcodeAndHoldMobilenum 获取验证码并继续使用这个手机号

接收参数：mobile=用getMobilenum方法获取到的手机号,uid=用户名,token=登录时返回的令牌,next_pid=下个要接收的项目ID,author_uid=开发者用户名(可选,传入此参数如果当前用户已经有上线则分提成金额的30%给开发者,如果没有上线则分提成金额的50%归开发者)

返回值：发送号码|验证码|下次获取验证码的token(暂时无用)

备注：返回值以|号分隔

[方法] getVcodeAndReleaseMobile 获取验证码并不再使用这个手机号

接收参数：mobile=用getMobilenum方法获取到的手机号,token=用loginIn方法获取到的token,uid=用户名,author_uid=开发者用户名(可选,传入此参数如果当前用户已经有上线则分提成金额的30%给开发者,如果没有上线则分提成金额的50%归开发者)

返回值：发送号码|验证码

备注：返回值以|号分隔

[方法] addIgnoreList 添加若干手机号到黑名单,可用于网站对此手机号的使用次数进行了限制

接收参数：pid=项目ID,mobiles=以,号分隔的手机号列表,uid=用户名,token=登录时返回的令牌

返回值：添加成功的数量

备注：如果为0则一个也没添加成功，可能已经存在在黑名单中了

[方法] clearIgnoreList 清空某项目中所有的黑名单

接收参数：pid=项目ID,uid=用户名,token=登录时返回的令牌

返回值：>0成功 代表清空的数量

备注：pid=0代表清空所有,否则只清空pid项目下的黑名单

[方法] getRecvingInfo 获取当前用户正在使用的号码列表

接收参数：pid=项目ID,uid=用户名,token=登录时返回的令牌

返回值：列表json数据(Pid=项目ID,Recnum=获取的号码,Timeout=超时时间秒,Start_time=获取时间)

备注：pid=0代表获取所有列表,否则只返回pid下的列表.根据Start_time和Timeout可算出这个号码的剩余可用时间.不用的号码请及时释放.

[方法] cancelSMSRecv 取消一个短信接收，可立即解锁被锁定的金额

接收参数：mobile=用getMobilenum方法获取到的手机号,token=用loginIn方法获取到的token,uid=用户名

返回值：成功=1

备注：无

[方法] cancelSMSRecvAll 取消所有短信接收，可立即解锁所有被锁定的金额

接收参数：uid=用户名,token=登录时返回的令牌

返回值：成功=1

备注：在多线程程序中不要随便调用,否则会取消当前用户所以获取到的号,影响其他线程.

[方法] checkUserRefer 检查一个用户是否为另一个用户的下线，用于软件开发者限制软件只能用自己的下线账号登录

接收参数：u=要检查的用户名,r_u=软件作者的用户名,意思为如果u是r_u的下线则返回1.

返回值：是=1

备注：无API

方便开发，自动接收短信API

示例代码下载

自动接收短信API

系统可提供自动化API供开发者开发自动化程序。如有不明白之处或自己没能力开发程序想找人开发的请加飞QAPI开发者交流群:159433030.无类似需求勿加.

下面是系统API的说明

地址： http://sms.xudan123.com/do.aspx

编码:UTF-8

统一参数调用方法

posturl: http://sms.xudan123.com/do.aspx

post数据:action=方法名&参数名1=值1....

如登录调用方法：

posturl: http://sms.xudan123.com/do.aspx

post数据:action=loginIn&uid=用户名&pwd=密码

 

所有API统一返回值含意

1:正常

unknow_error:未知错误,如果在获取号码或获取验证码时返回则再次请求就会正确返回.

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

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

not_found_moblie:没有找到手机号

login_error:用户名密码错误

mobile_exists:手机号己存在

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

parameter_error:传入参数错误

no_data:没有数据

project_state_error:项目状态不对,可能项目还没通过审核

mobile_state_error:手机号状态不对,立即放弃该号码，调用getMobilenum获取新的号码，不用加黑

max_count_disable:已经达到了可以获取手机号的最大数量，不要随便调用cancelSMSRecvAll释放,否则之前获取的所有号码将会失效.
此处应当考虑到户用积分不足的情况,如果调用了cancelSMSRecvAll程序会进入死循环,会一直重复获取号码然后遇到max_count_disable然后cancelSMSRecvAll然后再重复以上过程.

 

注意：

服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，没号了系统有监控会及时加号的。

系统限制同一个IP每秒只接受一次获取号码请求,如果同一秒有多次则其中一个请求将返回"message|please try again later",遇到这个请延迟当前线程500毫秒以上再次获取号码.

在发送短信完成后最好等待10秒再开始获取验证码，因为就算是正常手机接短信也是需要大概10秒时间的，如果服务器返回not_receive最好等待5秒后再次请求。

当然你可以根据自己的意愿自行设定发完短信等待时间和请求验证码间隔。最好不要一秒内请求一次或几次,否则有可能服务器会暂时封锁当前IP.

每个获取到的号码都必须正确处理(要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑，要么释放所有号码)，否则号码超时后系统会把你的获取号码数量惩罚值+1，这将导致你的可同时获取的号码数量减少。

在多线程程序中不要调用cancelSMSRecvAll,否则会影响其他线程的接收.调了cancelSMSRecvAll会释放当前用户下所有已经获取到的号码。

[方法] loginIn 登录

接收参数：uid:用户名,pwd:密码

返回值：uid:当前登录用户名,token:下面所有方法都要用的令牌

备注：无

[方法] getMobilenum 获取一个手机号

接收参数：pid=项目ID,uid=登录用户名,token=登录时返回的令牌

返回值：手机号|下次获取验证码的token(暂时无用)

备注：返回值以|号分隔

[方法] getVcodeAndHoldMobilenum 获取验证码并继续使用这个手机号

接收参数：mobile=用getMobilenum方法获取到的手机号,uid=用户名,token=登录时返回的令牌,next_pid=下个要接收的项目ID,author_uid=开发者用户名(可选,传入此参数如果当前用户已经有上线则分提成金额的30%给开发者,如果没有上线则分提成金额的50%归开发者)

返回值：发送号码|验证码|下次获取验证码的token(暂时无用)

备注：返回值以|号分隔

[方法] getVcodeAndReleaseMobile 获取验证码并不再使用这个手机号

接收参数：mobile=用getMobilenum方法获取到的手机号,token=用loginIn方法获取到的token,uid=用户名,author_uid=开发者用户名(可选,传入此参数如果当前用户已经有上线则分提成金额的30%给开发者,如果没有上线则分提成金额的50%归开发者)

返回值：发送号码|验证码

备注：返回值以|号分隔

[方法] addIgnoreList 添加若干手机号到黑名单,可用于网站对此手机号的使用次数进行了限制

接收参数：pid=项目ID,mobiles=以,号分隔的手机号列表,uid=用户名,token=登录时返回的令牌

返回值：添加成功的数量

备注：如果为0则一个也没添加成功，可能已经存在在黑名单中了

[方法] clearIgnoreList 清空某项目中所有的黑名单

接收参数：pid=项目ID,uid=用户名,token=登录时返回的令牌

返回值：>0成功 代表清空的数量

备注：pid=0代表清空所有,否则只清空pid项目下的黑名单

[方法] getRecvingInfo 获取当前用户正在使用的号码列表

接收参数：pid=项目ID,uid=用户名,token=登录时返回的令牌

返回值：列表json数据(Pid=项目ID,Recnum=获取的号码,Timeout=超时时间秒,Start_time=获取时间)

备注：pid=0代表获取所有列表,否则只返回pid下的列表.根据Start_time和Timeout可算出这个号码的剩余可用时间.不用的号码请及时释放.

[方法] cancelSMSRecv 取消一个短信接收，可立即解锁被锁定的金额

接收参数：mobile=用getMobilenum方法获取到的手机号,token=用loginIn方法获取到的token,uid=用户名

返回值：成功=1

备注：无

[方法] cancelSMSRecvAll 取消所有短信接收，可立即解锁所有被锁定的金额

接收参数：uid=用户名,token=登录时返回的令牌

返回值：成功=1

备注：在多线程程序中不要随便调用,否则会取消当前用户所以获取到的号,影响其他线程.

[方法] checkUserRefer 检查一个用户是否为另一个用户的下线，用于软件开发者限制软件只能用自己的下线账号登录

接收参数：u=要检查的用户名,r_u=软件作者的用户名,意思为如果u是r_u的下线则返回1.

返回值：是=1

备注：无