注意：客户端、卡商端下载后，必须解压才能使用(请勿直接双击压缩包使用)
重要申明：平台后台收到短信即计费，所以如果在未收到短信的情况下，请主动调用释放接口，如果任他不管，在后台强制释放前收到了短信照样计费。
接口调用需加入延时机制，否则会封帐号、IP。
接口地址：https://sms-szfang.com/yhapi
接口说明：汉字使用url编码
请求方式：仅支持get请求
尽可能把每次调用接口返回值保存日志，需要技术协助时，必须提供接口返回日志
接口返回“1|*”表示接口请求成功，返回“0|*”表示接口请求失败。*表示信息内容
该接口尽量只调用1次，在启动脚本的时候调用，无需循环调用
token在未修改账户密码前提下不变
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
login |
是 |
固定值，不允许修改 |
| UserName |
用户名 |
是 |
注册时的用户名 |
| PassWord |
登陆密码 |
是 |
注册时的登陆密码 |
请求示例：?act=login&UserName=1234&PassWord=4321
成功返回：1|token
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
用户账号不允许为空 |
| -2 |
用户账号不能包含特殊符号“|” |
| -3 |
用户账号不能包含汉字 |
| -4 |
用户密码不允许为空 |
| -5 |
账号已被禁用 |
| -6 |
账号或密码错误 |
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
myInfo |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
请求示例：?act=myInfo&token=b7c94daad5e3dd71ffca9298976ec0d4
成功返回：1|用户余额
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
getItem |
是 |
固定值，不允许修改 |
| key |
关键字 |
否 |
项目名称关键字，不传则获取全部项目信息 |
请求示例：?act=getItem&key=
成功返回：价目信息json
字段说明：
Game_ID：项目ID
Game_Name：项目名称
Game_Money：项目单价
Country_ID：国家代码
Country_Title：国家名称
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
getPhone |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
| gameid |
项目ID |
是 |
在用户端查看 |
| country |
国家代码 |
是 |
在接口文档末尾查看 |
| mobile |
指定手机号 |
|
获取指定的手机号 |
| seq |
指定号段 |
|
获取指定的号段 <三网:150 虚拟:162="" 广电:192=""> |
请求示例：?act=getPhone&token=b7c94daad5e3dd71ffca9298976ec0d4&gameid=1001&country=852&mobile=&seq=
成功返回：1|pkey|手机号
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
| -4 |
项目ID不允许为空 |
| -5 |
项目ID不存在 |
| -6 |
国家代码不允许为空 |
| -7 |
国家代码有误 |
| -8 |
余额不足,请充值 |
| -9 |
占号过多,请补充余额【未收到验证码强烈建议主动调用释放接口，否则在余额不多的情况下会提示占号过多】 |
| -10 |
指定号码有误 |
| -11 |
指定号段有误 |
| -12 |
暂时无号码 |
实现多次收码
流程：获取手机号-->触发第一个短信-->获取验证码-->指定手机号获取-->触发第二个短信-->获取验证码-->依此类推
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
getPhoneCode |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
| pkey |
接口二返回的pkey值 |
是 |
接口二（获取手机号接口）返回的pkey值 |
请求示例：?act=getPhoneCode&token=b7c94daad5e3dd71ffca9298976ec0d4&pkey=222
成功返回：1|完整短信内容
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
| -4 |
pkey无效 |
| -5 |
等待验证码 |
| -6 |
已离线或强制释放【请做好此判断，可以避免多个手机同时获取到相同号码的错觉】 |
没有收到短信都是以失败返回
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
sendCode |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
| pkey |
接口二返回的pkey值 |
是 |
接口二（获取手机号接口）返回的pkey值 |
| receiver |
接收方号码 |
是 |
接收短信的号码，如：10086 |
| smscontent |
短信内容 |
是 |
请勿发送违法短信 |
请求示例：?act=sendCode&token=b7c94daad5e3dd71ffca9298976ec0d4&pkey=222&receiver=10086&smscontent=cxye
成功返回：1|
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
| -4 |
pkey不允许为空 |
| -5 |
接收号码不能为空 |
| -6 |
提交短信不能为空 |
| -7 |
手机号不存在或已释放【请做好此判断，可以避免多个手机同时获取到相同号码的错觉】 |
仅在没有收到短信时调用，如果收到了短信无需调用此接口,释放存在失败的情况
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
setRel |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
| pkey |
接口二返回的pkey值 |
是 |
接口二（获取手机号接口）返回的pkey值 |
请求示例：?act=setRel&token=b7c94daad5e3dd71ffca9298976ec0d4&pkey=222
成功返回：1|
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| x |
x为正整数，表示x秒后才允许被释放。例如：返回0|30，表示30秒后才允许被释放 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
| -4 |
pkey无效 |
| -5 |
已回码,不允许释放 |
| -6 |
短信已提交发送,不允许释放 |
| -7 |
手机号不存在或已释放【请做好此判断，可以避免多个手机同时获取到相同号码的错觉】 |
仅在以后不想再用到这个号码时调用，其他非特殊情况无需调用此接口，加黑存在失败的情况
请求参数说明：
| 参数名 |
参数值 |
必传 |
参数说明 |
| act |
addBlack |
是 |
固定值，不允许修改 |
| token |
接口一返回的token值 |
是 |
接口一（用户登陆接口）返回的token值 |
| pkey |
接口二返回的pkey值 |
是 |
接口二（获取手机号接口）返回的pkey值 |
请求示例：?act=addBlack&token=b7c94daad5e3dd71ffca9298976ec0d4&pkey=222
成功返回：1|
失败返回：0|失败代号
失败代号说明：
| 失败代号 |
代号说明 |
| -1 |
Token不允许为空 |
| -2 |
账号已被禁用 |
| -3 |
Token不存在 |
| -4 |
pkey无效 |
| -5 |
订单不存在或是订单已完成或是该业务不支持发码【请做好此判断，可以避免多个手机同时获取到相同号码的错觉】 |