短信扩展发送
发送扩展短信
批量发送扩展短信
接口描述
发送短信,注意:为了提高发送速度和效率,相同内容的短信尽量不要单条提交
方法名
sendMesExt
承载协议
HTTP Get/Post
调用地址
http://112.124.24.5/api/MsgSend.asmx
请求参数
参数名 数据类型 说明
userCode string 登录名称
userPass string 登录密码
DesNo string 手机号码,多个号码用英文半角逗号分隔例如:13900000000,13900000001每次提交不多于500个号码
Msg string 短信内容。Get或者Post方式注意要用UTF8编码
Channel string 通道号。获取方式 账号开通后由云信提供问http://yes.itissm.com登录云信平台,进入“发短信”页面,在选择“发送通道”操作中点击下拉列表,可看到您拥有的通道。通道名称前面的阿拉伯数字即为通道号,如下图:

(本示例图所示通道号即为37,仅仅是示例请根据方法查看并使用自己的Channel)

ExeNo string 扩展号,可为空
返回值类型
string
成功返回值
返回本次提交的批次号(如:2114355899380234221),(或叫序列号、流水号等,提交一次返回一个)
失败返回值

返回带负号的失败代码,代码说明如下

失败状态码 状态码说明
-1 应用程序异常
-3 用户名密码错误或者用户无效
-5 签名不正确(格式为:XXX【签名内容】), 注意:短信内容最后一个字符必须是】
-6:keyWords 含有关键字keyWords(keyWords为敏感内容,如:-6:促销)
-7 余额不足
-8 没有可用的通道,或不在时间范围内
-9 发送号码一次不能超过1000个
-10 号码数量大于允许上限(不设置上限时,不可超过1000)
-11 号码数量小于允许下限
-12 模板不匹配
-13 Invalid Ip ip绑定用户,未绑定该ip
-14 用户黑名单
-15 系统黑名单
-16 号码格式错误
-17 无效号码(格式正常,可不是正确的电话号码,如12345456765)
-18 没有设置用户的固定下发扩展好,不能自定义扩展
-19 强制模板通道,不能使用个性化接口
-20 包含非法字符
-21 没有找到对应的submitID设置
-22 解密失败
-23 查询余额过频繁(至少间隔10秒)
C#代码示例
http请求

        string url="http://112.124.24.5/api/MsgSend.asmx";

        protected string sendmsgextByPost() //POST方式请求
        {
            StringBuilder sb = new StringBuilder();
            sb.Append("userCode=用户名&");
            sb.Append("userPass=密码&");
            sb.Append("DesNo=手机号&");
            sb.Append("Msg=短信内容【签名】&");
            sb.Append("Channel=通道号&");
            sb.Append("ExeNo=扩展号");
            string result = httpPost(url + "/sendMesExt", sb.ToString());
            return result;
        }

        protected string sendmsgextByGet() //Get方式请求
        {
            StringBuilder sb = new StringBuilder();
            sb.Append("userCode=用户名&");
            sb.Append("userPass=密码&");
            sb.Append("DesNo=手机号&");
            sb.Append("Msg=短信内容【签名】&");
            sb.Append("Channel=通道号&");
            sb.Append("ExeNo=扩展号");
            string result = httpGet(url + "/sendMesExt", sb.ToString());
            return result;
        }

        protected string httpGet(string url, string data) //http get请求
        {
            try
            {
                HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url + "?" + data);
                request.Method = "GET";
                request.ContentType = "text/html;charset=UTF-8";
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                Stream myResponseStream = response.GetResponseStream();
                StreamReader myStreamReader = new StreamReader(myResponseStream, Encoding.GetEncoding("utf-8"));
                string retString = myStreamReader.ReadToEnd();
                myStreamReader.Close();
                myResponseStream.Close();
                return retString;
            }
            catch (Exception ex)
            {

                return ex.Message;
            }
        }
        protected string httpPost(string url, string data) //http post请求
        {
            try
            {
                HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
                request.Method = "POST";
                request.ContentType = "application/x-www-form-urlencoded";
                byte[] info = Encoding.UTF8.GetBytes(data);
                using (Stream stream = request.GetRequestStream())
                {
                    stream.Write(info, 0, info.Length);
                }
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                Stream myResponseStream = response.GetResponseStream();
                StreamReader myStreamReader = new StreamReader(myResponseStream, Encoding.GetEncoding("utf-8"));
                string retString = myStreamReader.ReadToEnd();
                myStreamReader.Close();
                myResponseStream.Close();
                return retString;
            }
            catch (Exception ex)
            {
                return ex.Message;
            }
        }




                                    
webservice请求


       private void sendmsgext()
        {
            TopenServiceReference.MsgSendSoapClient topen = new TopenServiceReference.MsgSendSoapClient();
            string userName = "用户名";
            string passWord = "密码";
            string mobiles = "13900000000,13800000000,13100000000,……";
            string msgContent = "短信内容【签名】";
            string channel = "由拓鹏给您的通道编号";
            string ExeNo = "扩展号";
            string sendResult = topen.sendMesExt(userName, passWord, mobiles, msgContent, channel,"");

            //然后,根据返回的sendResult作相应处理
        }


                                    
PHP代码示例
http请求


<?php

$urlsend="http://112.124.24.5/api/MsgSend.asmx/sendMesExt";

$token=array("userCode"=>"用户名","userPass"=>"密码","DesNo"=>"手机号","Msg"=>"短信内容【签名】","Channel"=>"通道号","ExeNo"=>"扩展号");

echo http($urlsend,$token,"GET"); //get请求

echo http($urlsend,$token,"POST"); //post请求

function http($url,$param,$action="GET"){
	$ch=curl_init();
	$config=array(CURLOPT_RETURNTRANSFER=>true,CURLOPT_URL=>$url);
	if($action=="POST"){
		$config[CURLOPT_POST]=true;
	}
	$config[CURLOPT_POSTFIELDS]=http_build_query($param);
	curl_setopt_array($ch,$config);
	$result=curl_exec($ch);
	curl_close($ch);
	return $result;
}
?>

                                    
webservice请求


 	<?php
	//此处仅示例发送短信,其他可类推
	header("Content-type: text/html; charset=utf-8");
	$client = new SoapClient("http://112.124.24.5/api/MsgSend.asmx?WSDL");
	$param = array("userCode"=>"用户名","userPass"=>"密码","DesNo"=>"手机号","Msg"=>"短信内容【签名】","Channel"=>"通道号","ExeNo"=>"扩展号");
	$p = $client->sendMesExt($param);
	print_r($p);
	?>

                                    
java代码示例
http请求


                               //说明:此处需引用httpclient、httpcore、commons-logging三个jar包

        import java.io.BufferedReader;
        import java.io.IOException;
        import java.io.InputStream;
        import java.io.InputStreamReader;
        import java.util.*;
        import java.security.MessageDigest;
        import org.apache.http.HttpEntity;
        import org.apache.http.HttpResponse;
        import org.apache.http.client.HttpClient;
        import org.apache.http.client.methods.HttpPost;
        import org.apache.http.client.methods.HttpGet;
        import org.apache.http.client.entity.UrlEncodedFormEntity;
        import org.apache.http.impl.client.DefaultHttpClient;
        import org.apache.http.message.BasicNameValuePair;
        import org.apache.http.*;
        import javax.crypto.SecretKey;
        import javax.crypto.spec.DESKeySpec;
        import javax.crypto.spec.IvParameterSpec;
        import javax.crypto.SecretKeyFactory;
        import javax.crypto.Cipher;

        public static void main(String[] args) {
            String url="http://112.124.24.5/api/MsgSend.asmx/SendMesExt";

            List<NameValuePair> nvps = new ArrayList<NameValuePair>();
            nvps.add(new BasicNameValuePair("userCode", "用户名"));
            nvps.add(new BasicNameValuePair("userPass", "密码"));
            nvps.add(new BasicNameValuePair("DesNo", "手机号"));
            nvps.add(new BasicNameValuePair("Msg", "短信内容【签名】"));
            nvps.add(new BasicNameValuePair("Channel", "通道号"));
            nvps.add(new BasicNameValuePair("ExeNo", "扩展号"));
            String post=httpPost(url,nvps);  //post请求

            String getparam="userCode=用户名&userPass=密码&DesNo=手机号&Msg=短信内容【签名】&Channel=通道号&ExeNo=扩展号";
            String result=httpGet(url,getparam); //get请求
        }

    public static String httpPost(String url,List<NameValuePair> params) {
            String result = "";
        try {
            HttpClient httpclient = new DefaultHttpClient();
            HttpPost httpPost = new HttpPost(url);
            httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
            HttpResponse response = httpclient.execute(httpPost);
            HttpEntity entity = response.getEntity();
            if (entity != null) {
            	 InputStream instreams = entity.getContent();
            	 result = convertStreamToString(instreams);
                 System.out.println(result);
             }
        } catch (Exception e) {
        }
        return result;
    }

    public static String httpGet(String url,String params){
        String result="";
        try{
            HttpClient client=new DefaultHttpClient();
            if(params!=""){
                url=url+"?"+params;
            }
            HttpGet httpget=new HttpGet(url);
            HttpResponse response=client.execute(httpget);
            HttpEntity entity=response.getEntity();
            if (entity != null) {
            	 InputStream instreams = entity.getContent();
            	 result = convertStreamToString(instreams);
                 System.out.println(result);
             }
        }catch(Exception e){}
        return result;
    }

    public static String convertStreamToString(InputStream is) {
        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder sb = new StringBuilder();

        String line = null;
        try {
            while ((line = reader.readLine()) != null) {
                sb.append(line + "\n");
            }
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                is.close();
            } catch (IOException e) {
               e.printStackTrace();
            }
        }
        return sb.toString();
    }


                                    
webservice请求


       public static void main(String[] args) {
            org.tempuri.MsgSend service = new org.tempuri.MsgSend();
            org.tempuri.MsgSendSoap port = service.getMsgSendSoap();
            String result= port.sendMesExt("用户名","密码","手机号","短信内容【签名】","通道号","扩展号");
            System.out.println(result);
        }


                                    
asp代码示例
http请求


<%
dim sendurl,senddata
sendurl="http://112.124.24.5/api/MsgSend.asmx/SendMesExt"
senddata="userCode=用户名&userPass=密码&DesNo=手机号&Msg=短信内容【签名】&Channel=通道号&ExeNo=扩展号"

Response.Write(HTTPRequest(sendurl,senddata,"GET")) <!-- get请求 -->

Response.Write(HTTPRequest(sendurl,senddata,"POST")) <!-- post请求 -->


function HTTPRequest(url,data,method)
	dim http
	set http=server.createobject("MSXML2.SERVERXMLHTTP.3.0")

	if method = "GET" then
	Http.open "GET",url+"?"+data,false
	elseif method = "POST" then
	Http.open "POST",url,false
	end if

	Http.setRequestHeader "CONTENT-TYPE","application/x-www-form-urlencoded"
	Http.send(data)
	if Http.readystate<>4 then
	exit function
	End if

	HTTPRequest=BytesToStr(Http.responseBody,"utf-8")
	set http=nothing
	if err.number<>0 then err.Clear
End function

Function BytesToStr(body, charset)
    Dim objStream
    Set objStream = Server.CreateObject("Adodb.Stream")
    objStream.Type = 1
    objStream.Mode = 3
    objStream.Open
    objStream.Write body
    objStream.Position = 0
    objStream.Type = 2
    objStream.Charset = charset
    BytesToStr = objStream.ReadText
    objStream.Close
    Set objStream = Nothing
End Function

%>