PHP代码示例
//接口类型:互亿无线语音验证码接口。 //账户注册:请通过该地址开通账户http://user.ihuyi.com/register.html //注意事项: //(1)调试期间,请仔细阅读接口文档; //(2)请使用 APIID 及 APIKEY来调用接口,可在会员中心获取; //(3)该代码仅供接入互亿无线短信接口参考使用,客户可根据实际需要自行编写; header("Content-type:text/html; charset=UTF-8"); function Post($curlPost,$url){ $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_HEADER, false); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_NOBODY, true); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost); $return_str = curl_exec($curl); curl_close($curl); return $return_str; } function xml_to_array($xml){ $reg = "/<(\w+)[^-->]*>([\\x00-\\xFF]*)<\\/\\1>/"; if(preg_match_all($reg, $xml, $matches)){ $count = count($matches[0]); for($i = 0; $i < $count; $i++){ $subxml= $matches[2][$i]; $key = $matches[1][$i]; if(preg_match( $reg, $subxml )){ $arr[$key] = xml_to_array( $subxml ); }else{ $arr[$key] = $subxml; } } } return $arr; } $target = "http://api.voice.ihuyi.com/webservice/voice.php?method=Submit"; $mobile = '136xxxxxxxx';//手机号码 $post_data = "account=用户名&password=密码&mobile=".$mobile."&content=1125"; //查看用户名 登录用户中心->语音验证码>产品总览->API接口信息->APIID //查看密码 登录用户中心->语音验证码>产品总览->API接口信息->APIKEY $gets = xml_to_array(Post($post_data, $target)); if($gets['SubmitResult']['code']==2){ echo '提交成功'; }
JAVA代码示例
import java.io.IOException; import org.apache.commons.httpclient.HttpClient; import org.apache.commons.httpclient.HttpException; import org.apache.commons.httpclient.NameValuePair; import org.apache.commons.httpclient.methods.PostMethod; import org.dom4j.Document; import org.dom4j.DocumentException; import org.dom4j.DocumentHelper; import org.dom4j.Element; import util.StringUtil; //接口类型:互亿无线语音验证码接口。 //账户注册:请通过该地址开通账户http://user.ihuyi.com/register.html //注意事项: //(1)调试期间,请仔细阅读接口文档; //(2)请使用 APIID 及 APIKEY来调用接口,可在会员中心获取; //(3)该代码仅供接入互亿无线短信接口参考使用,客户可根据实际需要自行编写; public class sendsms { private static String Url = "http://api.voice.ihuyi.com/webservice/voice.php?method=Submit"; public static void main(String [] args) { HttpClient client = new HttpClient(); PostMethod method = new PostMethod(Url); //client.getParams().setContentCharset("GBK"); client.getParams().setContentCharset("UTF-8"); method.setRequestHeader("ContentType","application/x-www-form-urlencoded;charset=UTF-8"); NameValuePair[] data = {//提交短信 new NameValuePair("account", "用户名"),//查看用户名 登录用户中心->语音验证码>产品总览->API接口信息->APIID new NameValuePair("password", "密码"),//查看密码 登录用户中心->语音验证码>产品总览->API接口信息->APIKEY new NameValuePair("mobile", "139xxxxxxxx"),//手机号码 new NameValuePair("content", "1125"), }; method.setRequestBody(data); try { client.executeMethod(method); String SubmitResult = method.getResponseBodyAsString(); //System.out.println(SubmitResult); Document doc = DocumentHelper.parseText(SubmitResult); Element root = doc.getRootElement(); String code = root.elementText("code"); String msg = root.elementText("msg"); String voiceid = root.elementText("voiceid"); System.out.println(code); System.out.println(msg); System.out.println(voiceid); if("2".equals(code)){ System.out.println("短信提交成功"); } } catch (HttpException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (DocumentException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
通过POST、 GET 方式进行短信提交,数据编码采用utf-8格式,24小时全天发送。
http://api.voice.ihuyi.com/webservice/voice.php?method=Submit
参数名称 | 参数值描述 | 必填 |
account | APIID(请登录用户中心【语音验证码】-【产品纵览】查看) | 是 |
password | 1、APIKEY(请登录用户中心【语音验证码】-【产品纵览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明) |
是 |
mobile | 接收手机号码,只能提交1个号码 | 是 |
content | 验证码(4-6位数字) | 是 |
time | Unix时间戳(10位整型数字,当使用动态密码方式时为必填) | 否 |
format | 返回格式(可选值为:xml或json,系统默认为xml) | 否 |
用户通过http 或 https提交发送短信请求到服务器后,服务器会返回一串xml格式的字符串,SubmitResult结构说明如下:
参数名称 | 类型 | 描述 |
code | int | 返回值为2时,表示提交成功 |
smsid | string | 当提交成功后,此字段为流水号,否则为0 |
msg | string | 提交结果描述 |
示例(成功)
2
提交成功 60495654
示例(失败)
405
用户名或密码不正确 0
code | msg |
0 | 提交失败 |
2 | 提交成功 |
400 | 非法ip访问 |
401 | 帐号不能为空 |
402 | 密码不能为空 |
403 | 手机号码不能为空 |
4030 | 手机号码已被列入黑名单 |
404 | 语音内容不能为空 |
405 | 用户名或密码不正确 |
4050 | 账号被冻结 |
4051 | 剩余条数不足 |
4052 | 访问ip与备案ip不符 |
406 | 手机格式不正确 |
407 | 短信内容含有敏感字符 |
4070 | 语音验证码内容必须为4-6位数字 |
408 | 您的帐户疑被恶意利用,已被自动冻结,如有疑问请与客服联系。 |
http://api.voice.ihuyi.com/webservice/voice.php?method=Submit&account=APIID&password=APIKEY&mobile=手机号码&content=1125
code | msg |
0 | 提交失败 |
2 | 提交成功 |
400 | 非法ip访问 |
401 | 帐号不能为空 |
402 | 密码不能为空 |
403 | 手机号码不能为空 |
4030 | 手机号码已被列入黑名单 |
404 | 语音内容不能为空 |
405 | 用户名或密码不正确 |
4050 | 账号被冻结 |
4051 | 剩余条数不足 |
4052 | 访问ip与备案ip不符 |
406 | 手机格式不正确 |
407 | 短信内容含有敏感字符 |
4070 | 语音验证码内容必须为4-6位数字 |
408 | 您的帐户疑被恶意利用,已被自动冻结,如有疑问请与客服联系。 |
code | msg |
2 | 查询成功 |
400 | 非法ip访问 |
401 | 帐号不能为空 |
402 | 密码不能为空 |
405 | 用户名或密码不正确 |
4050 | 账号被冻结 |
语音通知接口一般采用http和webservice方式进行调用。使用语音通知http接口的效率比较高一些,它支持客户/服务器模式,运行速度很快,而webservice遇到一些比较复杂麻烦的数据类型时,处理起来更加有效。短信平台通常会将语音通知能力进行API封装,开发者仅需拷贝几行代码,即可在网站、APP、系统中轻松实现语音验证码、语音通知等短信内容的自动化发送。开发者用户可以通过不同开发语言,如GO进行语音通知接口开发。一般短信平台提供的语音通知发送服务,可支持全国移动、联通、电信手机号码,免除运营商之间不同通讯协议的烦恼。为了更方便开发者进行语音通知接入,短信平台会预先为开发者提供各语言的DEMO示例供开发者使用,仅需少量代码即可创建语音通知API请求。
GO语音通知的应用场景非常广泛,三大运营商特有的身份认证能力能够有效确保用户信息的准确性,因此语音通知也被应用在登录、注册、支付等高频次场景中,此外,会员通知也是很常见的短信应用场景之一,企业向自己的会员发送语音通知,将重要通知以语音形式播报,可以有效避免用户遗漏重要信息,有效减少了物流企业的售后成本,优化了用户服务体验。
现代企业对语音通知的应用越来越重视,其在游戏、广告、教育、五金、制造、卫浴等多个领域都有举足轻重的作用,企业通过语音验证码解决用户在登录、注册、支付等场景中的安全验证问题,为企业完善客户安全系统做出了卓越贡献。
语音验证码的出现极大地简化了用户注册登陆的流程,再过去,用户注册一个账号往往需要填写非常繁琐的资料,这往往会花费用户十多分钟的时间,但现在,用户注册账号通常只需要一个验证码,以往需要实际分钟才能完成的认证步骤现在只需要几十秒,短信基于三大运营商的身份认证能力可以确保信息的安全正确,在确保安全等级没有降低的情况下,大大优化了注册登陆的流程,深受企业及用户的喜爱。
GO短信接口接入流程大致分为四步:注册、测试、认证、充值、正式接入。语音通知支持测试使用,用户只需注册登陆,即可领取测试短信条数,完成技术对接,进行短信测试之后,用户完成企业认证和账户充值,服务即可正式上线。
短信接口是面向有一定技术开发能力的企业单独开发的接口能力,主要有HTTP、CMPP、SGIP、SMGP、WebService等形式,同时支持多种环境下的开发语言,如GO短信接口,用户可以通过将短信接口嵌入自身的系统中以拥有短信服务能力,其中,CMPP是中国移动的协议标准,协议以TCP/IP作为底层通讯承载,安全性更高。
GO语音通知接口使用的详细资讯,可进入帮助文档查看,也可向平台相关人员咨询。
150,000家
企业客户
20年
行业经验
2V1
2对1客户支持