shell语音短信api

  • 代码示例
  • API接口
  • 错误码参照

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();
        }
  
    }
  
}
                    
                    
                    
                    

1 接口描述

通过POST、 GET 方式进行短信提交,数据编码采用utf-8格式,24小时全天发送。

2 请求地址

http://api.voice.ihuyi.com/webservice/voice.php?method=Submit

3 请求参数

参数名称 参数值描述 必填
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 提交结果描述

4 响应示例

示例(成功)


 2 提交成功 60495654 

示例(失败)


 405 用户名或密码不正确 0 

5 响应参数

code msg
0 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 手机号码不能为空
4030 手机号码已被列入黑名单
404 语音内容不能为空
405 用户名或密码不正确
4050 账号被冻结
4051 剩余条数不足
4052 访问ip与备案ip不符
406 手机格式不正确
407 短信内容含有敏感字符
4070 语音验证码内容必须为4-6位数字
408 您的帐户疑被恶意利用,已被自动冻结,如有疑问请与客服联系。

6 请求示例

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 账号被冻结

自助开通云通信账户
免费试用,试用满意再购买

语音短信接口被广泛应用于网站、APP等互联网及移动互联网产品中,为了方便开发者集成语音短信服务,语音短信平台会面向开发者用户提供完整的语音短信开发相关文档,包含开放的语音短信接口api,采用通用的http或webservice,webservice就是使用soap协议且能处理一些比较复杂的数据,而http service通过post和get方式,方便集成各种软件系统。同时,一些语音短信平台也会针对如shell等开发语言提供语音短信DEMO实例代码,支持语音短信接口二次开发。语音短信平台也会提供简单易用的SUBHOOK ,在设置的事件触发后,将消息发送到你指定的回调 URL,通过SUBHOOK功能,开发者能够实时接收从网关发回的短信回执数据和语音短信的发送状态,甚至能实时接收到用户回复的内容。

shell语音短信的应用场景非常广泛,三大运营商特有的身份认证能力能够有效确保用户信息的准确性,因此语音短信也被应用在登录、注册、支付等高频次场景中,此外,会员通知也是很常见的短信应用场景之一,企业向自己的会员发送语音短信,将重要通知以语音形式播报,可以有效避免用户遗漏重要信息,有效减少了物流企业的售后成本,优化了用户服务体验。

现代企业对语音短信的应用越来越重视,其在游戏、广告、教育、五金、制造、卫浴等多个领域都有举足轻重的作用,企业通过语音验证码解决用户在登录、注册、支付等场景中的安全验证问题,为企业完善客户安全系统做出了卓越贡献。

语音验证码的出现极大地简化了用户注册登陆的流程,再过去,用户注册一个账号往往需要填写非常繁琐的资料,这往往会花费用户十多分钟的时间,但现在,用户注册账号通常只需要一个验证码,以往需要实际分钟才能完成的认证步骤现在只需要几十秒,短信基于三大运营商的身份认证能力可以确保信息的安全正确,在确保安全等级没有降低的情况下,大大优化了注册登陆的流程,深受企业及用户的喜爱。

企业用户对接短信流程非常简单,过程顺畅的话通常半个小时即可对接完成,在进行技术对接之前,用户需先注册短信平台账号,领取测试短信,随后即可进行技术对接,互亿无线提供完善的shell短信接口,如有疑问,也可寻求免费的技术支持,接入服务测试跑通之后,用户只需完成企业注册,充值账户即可正式上线服务。

目前主流的短信接口标准主要有HTTP、HTTPS、SMPP、CMPP、SMGP、SGIP等,其中最为常用的是HTTP、HTTPS两种短信接口协议,HTTP是超文本传输协议,信息是明文传输,简捷快速,允许传输任意类型的数据对象,同时限制单次链接只处理一个请求,节省传输时间,但是HTTP协议是无状态协议,对事务处理没有记忆能力,缺少状态必须重传,这样可能导致每次连接传送的数据量增大。

想要了解更多关于shell语音短信api的相关内容,请点击查看助文档,十分钟即可快速接入语音短信服务。

显示更多

上一个:Swift调用语音短信接口代码

下一个:shell语音通知demo

为您推荐
在线咨询
服务热线:
4008 808 898

免费体验

填写验证码后,点击“开通体验账户”自动开通体验账户。

收不到短信验证码?
×