免费接码平台-在线接收云短信验证码-Receive SMS Online China

1.获取分配号码

接口方法： GetHM2Str

接口说明：获取分配号码

传入参数： token,xmid,sl,lx,a1,a2,pk,ks,rj

参数	值	参数类型	必填	备注
token (登陆令牌)		string	是	字符型 UserLoginStr登陆接口时返回的token
xmid (项目编码)		int	是	请在Web端登陆查询要取号业务的对应项目编号
sl (取号数量)		int	是	要获取号码数量，可以是1到最大30
lx (号码类型)		int	是	数值型 lx=0是不限运营商，1是移动号码，2是联通号码，3是电信号码，4是外国号码，5是虚拟号，6是非虚拟号，130到189 是指定只获取指定号段，如：lx=136 是指定只获取分配136号码
a1 (省份)		string	否	非必填可为空，获取指定省份的号码（代码调用接口时用utf-8编码）
a2 (城市)		string	否	非必填可为空，获取指定城市的号码（代码调用接口时用utf-8编码）
pk (专属对接Key)		string	否	如果不是专属对接，该参数值为空，如果是专属对接可以填上对应专属Key
ks (卡商id编号)		int	是	数值型如果不需要获取指定卡商的号码，默认为：0
rj (作者帐户名)		string	是	平台开发作者帐户，用来计算提成，不需要值可空。（注册开发作者帐户名称请使用字母加数字唯一性，确保自己在其他平台也可以注册相同名称开发作者帐户，方便开发出来软件在各同类平台通用有提成，请不要使用其他中文或特殊字符）
				可以在线测试调用接口后参考浏览器的地址栏生成接口访问数据

调用返回值：string 字符串

返回值	说明	备注
hm=获取到号码	获取到号码数据，有多个号码用逗号分隔，	如一次取3个号码返回：hm=137*****1,136***2,137*****3
id=数值	返回选择排队获取号码任务Id编号，	当返回数据包含id=****时，说明服务器繁忙不能即时分配号码，已经帮生个获取号码任务Id用来二次查询获取号码，可在延时5-20秒之后用这个任务Id值再次调用GetTaskStr接口函数获取分配的号码。
空值	调用接口超时异常
-1	当前没有合条件号码
-2	提交取号任务超量，请释放占用号码	分配使用号码，做完任务或不用了需要把号码释放
-3	获取号码数量超量，请释放已经做完任务不使用的号码，以便获取新号码。
-4	该项目已经被禁用，暂停取号做业务
-8	帐户余额不足
-11	端口繁忙被占用，请稍后再试
-12	该项目不能以获取号码方式工作	特殊登陆验证项目只能用已经注册过号码指定号码使用，不能自动分配获取号码。（备注：请禁止使用是别人已经注册过项目的号码进行指定号码的验证登陆，否则别人投诉将被封帐号不退款。）
-15	查找不到该专属对应KEY	卡商没有生成有该对应专属KEY，或专属KEY已经被卡商删除了
0	没登陆或token过期	需要使用UserLoginStr重新登陆获取token

（软件开发作者请联系客服获取内部vip服务器IP使用，更快速稳定安全。）

GET方式调用方式： http://www.xnsms.com:9180/service.asmx/GetHM2Str?token=登陆令牌&xmid=项目编号&sl=号码数量&lx=号码类型&a1=省份&a2=城市&pk=专属对接KEY&ks=卡商Id编号&rj=作者帐户

接口调用实例：如作者帐户是abc123，获取指定卡商编号3，项目编号是200
http://www.xnsms.com:9180/service.asmx/GetHM2Str?token=2632120F90A971D9FB4771D97D507BFD&xmid=200&sl=1&lx=0&a1=&a2=&pk=&ks=3&rj=abc123

接口专属调用实例：如作者帐户是abc123，获取专属对接KEY:K000030003400180的号码，项目编号是200
http://www.xnsms.com:9180/service.asmx/GetHM2Str?token=2632120F90A971D9FB4771D97D507BFD&xmid=200&sl=1&lx=0&a1=&a2=&pk=K000030003400180&ks=0&rj=abc123

方法调用返回值示例如： hm=13712345678

注意事项：

1. 传递参数值如果是非英文或数字的字符，需要使用urlcode 的utf-8编码，查看编码是否正确，可以在线测试调用接口后参考浏览器的地址栏生成接口访问编码数据。

2. int类型参数值是必须要填，没有可以默认填0，如：ks=0。string类型参数非必填值可以为空，但参数名称必须要带有不能省略如：a1=

3. 当调用接口返回字符串是：id=数值，说明服务器繁忙不能即时分配号码，已经帮生个排队获取号码任务Id用来二次查询获取号码，可在延时5-10秒之后用这个任务Id值再次调用GetTaskStr接口函数获取分配的号码。

2.GetTaskStr（排队等待分配号码）

接口方法： GetTaskStr

接口说明：通过排队任务Id来获取号码

传入参数： token,id

参数	值(输入可直接测试)	参数类型	必填	备注
token (登陆令牌)		string	是	平台注册的普通帐户名称
id (取号排队Id)		int	是	GetHM2Str 接口返回的排队取号Id值
				可以在线测试调用接口后参考浏览器的地址栏生成接口访问数据

调用返回值：string 字符串

返回值	说明	备注
字符长度大于8	获取到号码数据	当返回有多个号码时，多个号码用逗号分隔。
空值	调用接口超时异常
1	任务Id还在等待分配号码中	可延时5-20秒后再次调用该任务接口获取号码
0	没登陆或token过期
-1	任务已结束或被已被中止或当前没有合条件号码	该任务Id已经失效，可以重新通过GetHMS2tr接口获取号码
-11	端口繁忙被占用，请稍后再试