自动接收短信API（通用版）.doc

自动接收短信API(通用版)
系统可提供自动化API供开发者开发自动化程序。如有不明白之处或自己没能力开发程序想找人开发的请加爱码API开发者交流群: .
下面是系统API的说明
地址: http://api.:8888/
编码:UTF-8
统一参数调用方法
posturl: http://api.:8888/
post数据:action=方法名&参数名1=值1....
如登录调用方法:
posturl: http://api.:8888/
post数据:action=loginIn&uid=用户名&pwd=密码
 
所有API统一返回值含意
wait_a_moment:数据加载中,请稍后进行操作。
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释放所有手机号后再获取手机号
1:正常
 接口接入流程图:
注意:
服务器返回no_data时表示系统暂时没有可用号码了,请使用死循环每隔一分钟请求一次手机号,爱码平台是不定时加号的。
每个获取到的号码都必须正确处理(要么获取验证码,要么号码不能用加黑,要么号码收不到短信加黑,要么解锁所有号码。
在多线程程序中不要调用cancelSMSRecvAll,。
[方法] loginIn 登录
接收参数:uid:用户名,pwd:密码
返回值:uid:当前登录用户名,token:下面所有方法都要用的令牌
备注:无
[方法] getMobilenum 获取一个手机号
接收参数:pid=项目ID,uid=登录用户名,token=登录时返回的令牌size=获取号码数(可以不填,默认为1)
返回值:手机号|下次获取验证码的token(暂时无用)
多个号码返回值:手机号;手机号|下次获取验证码的token(暂时无用)
备注:返回值以|号分隔
[方法] getVcodeAndHoldMobilenum 获取验证码并继续使用这个手机号
接收参数:mobile=用getMobilenum方法获取到的手机号,uid=用户名,token=登录时返回的令牌,next_pid=下个要接收的项目ID,author_u