API接口调用例子

(说明:以下例子用普通帐户“fjs”密码“123456”调用接口, 实际环境调用时可能需要把例子中的域名:www.js-yzm.com 可指定替换成平台某个VIP服务器的IP地址)

平台支持一次获取多个号码,如一次需要获取10个可做该项目的号码,把例子中获取号码数量值 sl=1 改成 sl=10,返回多个号码用半角逗号分隔,如一次取10个号码返回:hm=137*******1,136*******2,137*******3,*******等

如果在GetYzmStr调用中因网络不稳定或超时等出现异常情况验证码数据丢包了,可以调用GetYzmLogStr重试获取验证码接口函数取回之前历史记录验证码数据

一、单号码做单项目例子,假设要做任务的项目编号200

1.调用UserLoginStr接口函数登陆获取会话Token:
http://www.js-yzm.com:9180/service.asmx/UserLoginStr?name=fjs&psw=123456 说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8,使用时请用客户帐户替换例子的fjs和密码12345 2.调用GetHM2Str接口函数获取可做项目的号码,参数pk传递 值为空即可,是专属对接时才传递对应的专属KEY
http://www.js-yzm.com:9180/service.asmx/GetHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=200&sl=1&lx=0&a1=&a2=&pk=&ks=0&rj=0 说明:接口返回正常如:hm=13012345678,一次取多号码返回多个号码用半角逗号分隔,如返回其他值请参考GetHM2Str接口函数详细说明处理,如接口繁忙返回等待获取号码值是id=123***这样Id数值,需要使用GetTaskStr接口函数再去查询获取分配的号码。 3.调用GetYzm2Str接口函数获取接收验证码短信:
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0 说明:接口正常返回如:309260 http://*.*.*.*/veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明手机号码还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 4.完成项目任务处理后调用sfHmStr接口函数注销释放号码:
http://www.js-yzm.com:9180/service.asmx/sfHmStr?token=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5.如要继续开始新一次任务,重复2,3,4 步骤即可。

二、单号码同时做多个项目任务例子,假设要做2个短信项目任务的编号是:200和760 ,要做语音项目任务编号是:30001

1.调用UserLoginStr接口函数登陆获取会话Token:
http://www.js-yzm.com:9180/service.asmx/UserLoginStr?name=fjs&psw=123456  说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8  ,使用时请用客户帐户替换例子的fjs和密码12345 2.调用GetHM2Str接口函数获取可做项目的号码,如果是语音项目和短信项目一起做,必须用语音项目编号获取号码,这样才能保证获取到能同时做语音的卡号,参数pk传递空值如是专属对接时才传递对应专属KEY
http://www.js-yzm.com:9180/service.asmx/GetHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=30001&sl=1&lx=0&a1=&a2=&pk=&ks=0&rj=0   说明:接口返回正常如:hm=13012345678  ,如返回其他值请参考GetHM2Str接口函数详细说明处理,如接口繁忙返回等待获取号码值是id=123*** 这样Id数值,需要使用GetTaskStr接口函数再去查询获取分配的号码。 3.调用mkHM2Str接口函数 指定在步骤2获取到号码做剩下200和760项目任务:
做200项目任务:
http://www.js-yzm.com:9180/service.asmx/mkHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=200&hm=13012345678&op=0&pk=&rj=0
做760项目任务:
http://www.js-yzm.com:9180/service.asmx/mkHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=760&hm=13012345678&op=0&pk=&rj=0   说明:接口返回正常如:1  ,如返回其他值请参考mkHM2Str接口函数详细说明处理 4.调用GetYzm2Str接口函数分别去获取3个项目中自己对应项目的接收验证码短信
获取200项目验证码 
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0  
获取760项目验证码 
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=760&sf=0  
获取30001项目验证码
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=30001&sf=0   说明:接口正常返回如:309260 http://*.*.*.*/veifycode_record/000610509-10105757-4476.wav  ,如返回值是:1 说明该项目还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取对应项目的验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。理。 5.当3个项目都返回验证码完成项目任务处理后调用sfHmStr接口函数注销释放号码,注意:如果3个项目中还有某个项目没返回验证码完成某个任务,不能调用该接口释放号码,否则释放后剩下没完成项目将被中止结束。
http://www.js-yzm.com:9180/service.asmx/sfHmStr?token=132A49069398917D4C666B1BA77242C8&hm=13012345678   说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 6.如要继续开始新一次做多项目任务,重复2,3,4,5 步骤即可。

专属API 接口调用例子

(说明:以下例子用普通帐户“fjs”密码“123456”调用接口, 实际环境调用时可能需要把例子中的域名:www.js-yzm.com 可指定替换成平台某个VIP服务器的IP地址)

一、专属单号码做单项目例子,假设卡商专属项目编号200的对接Key为:K001247

1.调用UserLoginStr接口函数登陆获取会话Token:
http://www.js-yzm.com:9180/service.asmx/UserLoginStr?name=fjs&psw=123456  说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8,使用时请用客户帐户替换例子的fjs和密码12345 2.调用GetHMStr接口函数获取可做项目的号码,参数pk传递对应的专属KEY值:
http://www.js-yzm.com:9180/service.asmx/GetHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=200&sl=1&lx=0&a1=&a2=&pk=K001247&ks=0&rj=0   说明:接口返回正常如:hm=13012345678  ,如返回其他值请参考GetHM2Str接口函数详细说明处理,如接口繁忙返回等待获取号码值是id=123*** 这样Id数值,需要使用GetTaskStr接口函数再去查询获取分配的号码。 3.调用GetYzm2Str接口函数获取接收验证码短信:
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0   说明:接口正常返回如:309260 http://*.*.*.*/veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明手机号码还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 4.完成项目任务处理后调用sfHmStr接口函数注销释放号码:
http://www.js-yzm.com:9180/service.asmx/sfHmStr?token=132A49069398917D4C666B1BA77242C8&hm=13012345678   说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5.如要继续开始新一次任务,重复2,3,4 步骤即可。

二、专属单号码同时做多个专属项目例子,假设要做2个专属短信项目任务的编号是:200和760 ,要做专属语音项目任务编号是:30001

注意:多个专属项目必须要是同一个卡商提供,假设专属项目200的卡商专属KEY是:K00200 ,专属项目760的专属KEY是:K00760,专属语音项目30001的KEY是:K30001

1.调用UserLoginStr接口函数登陆获取会话Token:
http://www.js-yzm.com:9180/service.asmx/UserLoginStr?name=fjs&psw=123456  说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8  ,使用时请用客户帐户替换例子的fjs和密码12345 2.调用GetHMStr接口函数获取可做项目的号码,如果是语音项目和短信项目一起做,必须用语音项目编号获取号码,这样才能保证获取到能同时做语音的卡号,参数pk传递对应的专属KEY值:
http://www.js-yzm.com:9180/service.asmx/GetHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=30001&sl=1&lx=0&a1=&a2=&pk=K30001&ks=0&rj=0 说明:接口返回正常如:hm=13012345678  ,如返回其他值请参考GetHMStr接口函数详细说明处理。 3.调用mkHM2Str接口函数 指定在步骤2获取到号码做剩下200和760专属项目任务
做200项目任务:
http://www.js-yzm.com:9180/service.asmx/mkHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=200&hm=13012345678&op=0&pk=K00200&rj=0
做760项目任务:
http://www.js-yzm.com:9180/service.asmx/mkHM2Str?token=132A49069398917D4C666B1BA77242C8&xmid=760&hm=13012345678&op=0&pk=K000760&rj=0

4.调用GetYzm2Str接口函数分别去获取3个项目中自己对应项目的接收验证码短信:
获取200项目验证码:
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0
获取760项目验证码 :
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=760&sf=0
获取30001项目验证码 :
http://www.js-yzm.com:9180/service.asmx/GetYzm2Str?token=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=30001&sf=0 说明:接口正常返回如:309260 http://*.*.*.*/veifycode_record/000610509-10105757-4476.wav  ,如返回值是:1 说明该项目还没收到验证码信息,需要间隔5-10秒后调用GetYzmStr接口继续到平台获取对应项目的验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5.当3个项目都返回验证码完成项目任务处理后调用sfHmStr接口函数注销释放号码。

注意:如果3个项目中还有某个项目没返回验证码完成某个任务,不能调用该接口释放号码,否则释放后剩下没完成项目将被中止结束。


http://www.js-yzm.com:9180/service.asmx/sfHmStr?token=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 6.如要继续开始新一次做多项目任务,重复2,3,4,5 步骤即可。