飞鱼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/UserLoginStr?name=fjs&psw=123456如出错联系客服
说明:接口返回正常Token 如:132A49069398917D4C666B1BA77242C8,使用时请用客户帐户替换例子的fjs和密码12345
2.调用GetHM2Str接口函数获取可做项目的号码,参数pk传递 值为空即可,是专属对接时才传递对应的专属KEY
http://dkh.d1tm.com/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://dkh.d1tm.com/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://dkh.d1tm.com/service.asmx/sfHmStr?token=132A49069398917D4C666B