飞鱼API接口例子 (说明:以下例子用普通帐户“fjs”密码“123456”调用接口, 实际环境调用时可能需要把例子中的域名:www.d1tm.com 可指定替换成平台某个VIP服务器的域名,语音等待验证码时间应该为200秒,短信70秒,这样成功率更高!) 飞鱼平台支持一次获取多个号码,如一次需要获取10个可做该项目的号码,把例子中获取号码数量值 sl=1 改成 sl=10,返回多个号码用半角逗号分隔,如一次取10个号码返回:hm=1371,1362,137*******3,*******等 如果在GetYzmStr调用中因网络不稳定或超时等出现异常情况验证码数据丢包了,可以调用GetYzmLogStr重试获取验证码接口函数取回之前历史记录验证码数据 一、单号码做单项目例子,假设要做任务的项目编号200 1、调用UserLoginStr接口函数登陆获取会话Token: http://dkh.d1tm.com/service.asmx/UserLoginStrname=fjs&psw=123456如出错联系客服 说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8,使用时请用客户帐户替换例子的fjs和密码12345 2、调用GetHM2Str接口函数获取可做项目的号码,参数pk传递 值为空即可,是专属对接时才传递对应的专属KEY http://dkh.d1tm.com/service.asmx/GetHM2Strtoken=132A49069398917D4C666B1BA77242C8&xmid=200&sl=1&lx=0&a1=&a2=&pk=&ks=0&rj=0 说明:接口返回正常如:hm=13012345678,一次取多号码返回多个号码用半角逗号分隔,如返回其他值请参考GetHM2Str接口函数详细说明处理,如接口繁忙返回等待获取号码值是id=123这样Id数值,需要使用GetTaskStr接口函数再去查询获取分配的号码。 3、调用GetYzm2Str接口函数获取接收验证码短信: http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0 说明:接口正常返回如:309260 http://...*/veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明手机号码还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 4、完成项目任务处理后调用sfHmStr接口函数注销释放号码: http://dkh.d1tm.com/service.asmx/sfHmStrtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5、如要继续开始新一次任务,重复2,3,4 步骤即可。 二、单号码同时做多个项目任务例子,假设要做2个短信项目任务的编号是:200和760 ,要做语音项目任务编号是:30001 1、调用UserLoginStr接口函数登陆获取会话Token: http://dkh.d1tm.com/service.asmx/UserLoginStrname=fjs&psw=123456 说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8 ,使用时请用客户帐户替换例子的fjs和密码12345 2、调用GetHM2Str接口函数获取可做项目的号码,如果是语音项目和短信项目一起做,必须用语音项目编号获取号码,这样才能保证获取到能同时做语音的卡号,参数pk传递空值如是专属对接时才传递对应专属KEY http://dkh.d1tm.com/service.asmx/GetHM2Strtoken=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://dkh.d1tm.com/service.asmx/mkHM2Strtoken=132A49069398917D4C666B1BA77242C8&xmid=200&hm=13012345678&op=0&pk=&rj=0 做760项目任务: http://dkh.d1tm.com/service.asmx/mkHM2Strtoken=132A49069398917D4C666B1BA77242C8&xmid=760&hm=13012345678&op=0&pk=&rj=0 说明:接口返回正常如:1 ,如返回其他值请参考mkHM2Str接口函数详细说明处理 4、调用GetYzm2Str接口函数分别去获取3个项目中自己对应项目的接收验证码短信 获取200项目验证码 http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0 获取760项目验证码 http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=760&sf=0 获取30001项目验证码 http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=30001&sf=0 说明:接口正常返回如:309260 http://.../veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明该项目还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取对应项目的验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。理。 5、当3个项目都返回验证码完成项目任务处理后调用sfHmStr接口函数注销释放号码,注意:如果3个项目中还有某个项目没返回验证码完成某个任务,不能调用该接口释放号码,否则释放后剩下没完成项目将被中止结束。 http://dkh.d1tm.com/service.asmx/sfHmStrtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 6、如要继续开始新一次做多项目任务,重复2,3,4,5 步骤即可。 专属API 接口调用例子 (说明:以下例子用普通帐户“fjs”密码“123456”调用接口, 实际环境调用时可能需要把例子中的域名:www.waixing666.com 可指定替换成平台某个VIP服务器的IP地址) 一、专属单号码做单项目例子,假设卡商专属项目编号200的对接Key为:K001247 1、调用UserLoginStr接口函数登陆获取会话Token: http://dkh.d1tm.com/service.asmx/UserLoginStrname=fjs&psw=123456 说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8,使用时请用客户帐户替换例子的fjs和密码12345 2、调用GetHMStr接口函数获取可做项目的号码,参数pk传递对应的专属KEY值: http://dkh.d1tm.com/service.asmx/GetHM2Strtoken=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://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0 说明:接口正常返回如:309260 http://.../veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明手机号码还没收到验证码信息,需要间隔5-10秒后调用GetYzm2Str接口继续到平台获取验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 4、完成项目任务处理后调用sfHmStr接口函数注销释放号码: http://dkh.d1tm.com/service.asmx/sfHmStrtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5、如要继续开始新一次任务,重复2,3,4 步骤即可。 二、专属单号码同时做多个专属项目例子,假设要做2个专属短信项目任务的编号是:200和760 ,要做专属语音项目任务编号是:30001 注意:多个专属项目必须要是同一个卡商提供,假设专属项目4586的卡商专属KEY是:zx006786 ,专属项目4586的专属KEY是:zx006786,专属语音项目6873的KEY是:K3873 1、调用UserLoginStr接口函数登陆获取会话Token: http://dkh.d1tm.com/service.asmx/UserLoginStrname=fjs&psw=123456 说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8 ,使用时请用客户帐户替换例子的fjs和密码12345 2、调用GetHMStr接口函数获取可做项目的号码,如果是语音验证码和短信验证码同时做,必须用语音项目编号获取号码,这样才能保证获取到能同时做语音的手机号,参数pk传递对应的专属KEY值: http://dkh.d1tm.com/service.asmx/GetHM2Strtoken=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://dkh.d1tm.com/service.asmx/mkHM2Strtoken=132A49069398917D4C666B1BA77242C8&xmid=200&hm=13012345678&op=0&pk=K00200&rj=0 做760项目任务: http://dkh.d1tm.com/service.asmx/mkHM2Strtoken=132A49069398917D4C666B1BA77242C8&xmid=760&hm=13012345678&op=0&pk=K000760&rj=0 4、调用GetYzm2Str接口函数分别去获取3个项目中自己对应项目的接收验证码短信: 获取200项目验证码: http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=200&sf=0 获取760项目验证码 : http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=760&sf=0 获取30001项目验证码 : http://dkh.d1tm.com/service.asmx/GetYzm2Strtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678&xmid=30001&sf=0 说明:接口正常返回如:309260 http://.../veifycode_record/000610509-10105757-4476.wav ,如返回值是:1 说明该项目还没收到验证码信息,需要间隔5-10秒后调用GetYzmStr接口继续到平台获取对应项目的验证码短信,直到返回验证码为止,如果是返回其他参数值请参考接口文档详细返回值说明处理。 5、当3个项目都返回验证码完成项目任务处理后调用sfHmStr接口函数注销释放号码。 注意:如果3个项目中还有某个项目没返回验证码完成某个任务,不能调用该接口释放号码,否则释放后剩下没完成项目将被中止结束。 http://dkh.d1tm.com/service.asmx/sfHmStrtoken=132A49069398917D4C666B1BA77242C8&hm=13012345678 说明:接口正常返回如:1 ,如果是返回其他参数值请参考接口文档详细返回值说明处理。 6、如要继续开始新一次做多项目任务,重复2,3,4,5 步骤即可。 |