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

速码验证码接收平台API接口A版速码验证码平台API接口文档A版一、统一说明为了让开发者更快更便捷的接入速码平台，速码团队开发了A版B版两套API接口，两者并无差别，均可兼容，实现了只需更换网址即可将现有软件快速接入速码。接口地址：/httpApi.do2action二接口统一编码：UTF-8接口调用方式：HTTP,支持GET和POST两种方式。GET方式调用实例：/httpApi.do?action=方法名&参数1二值&参数2二值（具体方法名及参数请参考接口方法）。软件开发者说明：服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，速码平台是不定时加号的。max_count_disable出现这个提示是因为您获取的号码没有正常处理，每个获取到的号码都必须正确处理（要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑。getRecvingInfo方法可以查看您当前获取的手机号码如果接口返回action_parameter_error表示传入方法名错误或方法不存在。1/13速码验证码接收平台API接口A版软件作者账号无需另外注册，在获取验证码方法中上传一个速码账号即可获得分成。若该分成账号在平台消费，则会优先消费获得的分成金额。二、接口方法1、用户登录1）方法名：loginIn2）传入参数：uid:用户名:pwd:密码3）GET方式调用实例：/httpApi.do?action=loginIn&uid二用户名&pwd二密码4）方法调用返回值示例：1））成功返回：用户名|token（下面所有方法都要用的令牌）2））失败返回值&说明：login_error用户名密码错误2/13速码验证码接收平台API接口A版message1速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试account_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定account_is_FreezeUser账号被冻结2、获取用户个人信息1）方法名：getUserInfos2）传入参数：uid:用户名仿女。门=登录时返回的令牌3）GET方式调用实例：/httpApi.do2action=getUserInfos&uid二用户名口。女。「=登录时返回的令牌4）方法调用返回值示例：1））成功返回：用户名;积分;余额;可同时获取号码数2））失败返回值&说明：3/13速码验证码接收平台API接口A版parameter_error传入参数错误not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,tokenaccount_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定message|pleasetryagainlater访问速度过快，建议休眠50毫秒后再试unknow_error未知错误,再次请求就会正确返回3、获取手机号码1）方法名：getMobilenum2）传入参数：pid=项目IDuid二登录用户名仿女。门=登录时返回的令牌mobile二指定号码获取（可以不填写该参数，如填入格式不正确则获取新号码）size二获取号码数（可以不填，默认为1，1〈=size<=10）4/13速码验证码接收平台API接口A版province=归属地（省份，例如：广东、北京）province值：广东|辽宁|湖南|内蒙古|浙江|安徽|贵州|西藏|黑龙江|陕西|广西济北|福建|山西|江西|海南|江苏|云南|河南|山东|新疆|青海|吉林|河北|宁夏|北京1天津|上海|四川|重庆|甘肃province中文传参时可能产生乱码，最好经过URL转码，（例如：java转码方式.URLEncoder.encode（"广东〃，〃UTF-8〃））。phoneType二运营商（CMCC（移动）、UNICOM（联通）、TELECOM（电信））。3）GET方式调用实例：/httpApi.do2action=getMobilenum&pid=项目ID&uid二用户名上。女。「=登录时返回的令牌&mobile=&size=14）归属地、运营商调用实例：/httpApi.do2action=getMobilenum&pid=项目ID&uid二用户名上。女。「=登录时返回的令牌&mobile=&size=1&province=广东&phoneType=CMCC5）方法调用返回值示例:5/13速码验证码接收平台API接口A版1））成功返回：手机号码Itoken注意：多个号码返回值：手机号;手机号;手机号|token2））失败返回值&说明：no_data系统暂时没有可用号码了parameter_error传入参数错误not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,tokenaccount_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定message1速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试not_found_project没有找到项目，项目ID不正确message|q使用余额不足可使用余额不足max_count_disable已经达到了当前等级可以获取手机号的最大数量,请先处理完您手上的号码再获取新的号码（处6/13速码验证码接收平台API接口A版理方式：能用的号码就获取验证码，不能用的号码就加黑）unknow_error未知错误,再次请求就会正确返回4、获取验证码并不再使用本号1）方法名：getVcodeAndReleaseMobile2）传入参数：mobile二用getMobilenum方法获取到的手机号仿女。门=登录时返回的令牌uid二用户名author_uid=软件开发者用户名（可选，可得10%的消费分成）3）GET方式调用实例：/httpApi.do2action=getVcodeAndReleaseMobile&uid=用户名&token=登录时返回的令牌&mobile二获取到的手机号码&author_uid=软件开发者用户名（可选，可得10%的消费分成）4）方法调用返回值示例：1））成功返回：手机号码I验证码短信7/13速码验证码接收平台API接口A版2））失败返回值&说明：not_receive还没有接收到验证码,请让程序等待几秒后再次尝试parameter_error传入参数错误not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,tokenaccount_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定message|pleasetryagainlater访问速度过快，建议休眠50毫秒后再试message|q使用余额不足可使用余额不足not_found_moblie没有找到手机号not_found_project没有找到项目，项目ID不正确5、获取验证码并继续使用本号1）方法名:getVcodeAndHoldMobilenum2）传入参数：mobile二用getMobilenum方法获取到的手机号8/13速码验证码接收平台API接口A版uid二用户名伪女㊀联登录时返回的令牌next_pid=下个要接收的项目IDauthor_uid=软件开发者用户名（可选，可得10%的消费分成）3）GET方式调用实例：/httpApi.do2action=getVcodeAndHoldMobilenum&uid=用户&token=登录时返回的令牌&mobile二获取到的手机号码&next_pid=下个要接收的项目ID&author_uid=软件开发者用户名（可选，可得10%的消费分成）4）方法调用返回值示例：1））成功返回：发送号码I验证码Itoken2））失败返回值&说明：not_receive还没有接收到验证码,请让程序等待几秒后再次尝试parameter_error传入参数错误9/13速码验证码接收平台API接口A版not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,tokenaccount_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定message|pleasetryagainlater访问速度过快，建议休眠50毫秒后再试message|q使用余额不足可使用余额不足not_found_moblie没有找到手机号not_found_project没有找到项目，项目ID不正确unknow_error未知错误,再次请求就会正确返回6、加黑无用号码1）方法名：addIgnoreList2）传入参数：pid=项目IDmobiles=以,号分隔的手机号列表uid二用户名仿女。门=登录时返回的令牌10/13速码验证码接收平台API接口A版3）GET方式调用实例：/httpApi.do2action=addIgnoreList&uid二用户名&token=登录时返回的令牌&mobiles二号码1,号码2,号码3&pid=项目ID4）方法调用返回值示例：1））成功返回：加黑成功的号码数量2））失败返回值&说明：parameter_error传入参数错误not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,tokenaccount_is_locked账号被锁定account_is_stoped账号被停用account_is_question_locked账号已关闭account_is_ip_stoped账号ip锁定unknow_error未知错误,再次请求就会正确返回7、已获取号码列表1）方法名：getRecvingInfo11/13速码验证码接收平台API接口A版2）传入参数:uid二用户名伪女㊀联登录时返回的令牌pid=项目ID（pid等于0的时候获取所有号码，pid不等于0的时候获取指定项目号码）3）GET方式调用实例：/httpApi.do2action=getRecvingInfo&uid二用户名&pid=项目1口凯。卜6门=登录时返回的令牌4）方法调用返回值示例：1））成功返回：没有获取号码记录：［］单条：［｛"Pid〃:项目ID,〃Recnum〃:号码,〃Timeout〃:号码超时释放所剩时间，〃Start_time〃:获取号码时间｝］”^^。。□土〃以秒为单位）多条：［｛〃Pid〃:项目ID,〃Recnum〃:号码,"Timeout〃:号码超时释放所剩时间,〃Start_time〃:获取号码时间｝,｛〃Pid〃:项目ID,〃Recnum〃:号码,〃Timeout〃:号码超时释放所剩时间，〃Start_time〃:获取号码时间｝,｛...｝］（"^^。。□土〃以秒为单位）2））失败返回值说明:12/13速码验证码接收平台API接口A版parameter_error传入参数错误not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,