请求地址:

http://120.77.14.55:8888/v2sms.aspx    对应UTF-8

http://120.77.14.55:8888/v2smsGBK.aspx    对应GB2312

请求参数

参数名称含义说明
userid企业id企业ID
timestamp时间戳系统当前时间字符串,年月日时分秒,例如:20120701231212
sign签名使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test 
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
其他参数没错的话,提示错误的时候检查加密结果对不对。
mobile全部被叫号码发信发送的目的号码.多个号码之间用半角逗号隔开
content发送内容短信的内容,内容需要UTF-8编码
sendTime定时发送时间为空表示立即发送,定时发送格式2010-10-24 09:08:10
action发送任务命令设置为固定的:send
extno扩展子号请先询问配置的通道是否支持扩展子号,如果不支持,请填空。子号只能为数字,且最多10位数。


响应参数

名称类型示例描述
returnsmString
Xml根元素
returnstatusBooleanSuccess返回状态值:成功返回Success 失败返回:Faild
messageStringok返回信息描述
remainpointInt123返回余额
taskIDInt54215257返回本次任务的序列ID
successCountsInt2成功短信数:当成功后返回提交成功短信数

请求示例(c#)

public string SendSMS(string userid, string timestamp, string sign, string mobile, string content, 
string sendTime, string extno)
          {
               string requestUrl = string.Format("{0}/v2sms.aspx", SITEURL);
               StreamReader reader;
               Uri requestUri = new Uri(requestUrl);
               HttpWebRequest request = (HttpWebRequest)WebRequest.Create(requestUri);
               request.Method = "POST";
               request.ContentType = "application/x-www-form-urlencoded";
               request.KeepAlive = true;
               request.Timeout = 1000000;

               StringBuilder data = new StringBuilder();
               data.Append("action=send");
               data.Append(string.Format("&userid={0}", userid));
               data.Append(string.Format("×tamp={0}", timestamp));
               data.Append(string.Format("&sign={0}", sign));
               data.Append(string.Format("&content={0}", content));
               data.Append(string.Format("&mobile={0}", mobile));
               data.Append(string.Format("&extno={0}", extno));
               data.Append(string.Format("&sendTime={0}", sendTime));

               byte[] byteData = UTF8Encoding.UTF8.GetBytes(data.ToString());  
     request.ContentLength = byteData.Length;
               using (Stream postStream = request.GetRequestStream())
               {
                   postStream.Write(byteData, 0, byteData.Length);
               }
               WebResponse response = (HttpWebResponse)request.GetResponse();
               reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
               StringBuilder builder = new StringBuilder();
               char[] buffer = new char[0x400];
               int charCount = 0;
               while ((charCount = reader.Read(buffer, 0, buffer.Length)) › 0)
               {
                   builder.Append(buffer, 0, charCount);
               }
               reader.Close();
               return builder.ToString();

响应示例

                  ‹?xml version="1.0" encoding="utf-8" ?›
                  ‹returnsms›
                  ‹returnstatus›status ‹/returnstatus› 
                  ‹message›message‹/message› 
                  ‹remainpoint› remainpoint‹/remainpoint›
                  ‹taskID›taskID‹/taskID› 
                  ‹successCounts›successCounts‹/successCounts› 
                  ‹/returnsms›

异常示例

	      ‹?xml version="1.0" encoding="utf-8" ?›
              ‹returnsms›
              ‹returnstatus›Faild‹/returnstatus› 
              ‹message›签名错误‹/message› 
              ‹remainpoint› 0‹/remainpoint›
              ‹taskID›0‹/taskID› 
              ‹successCounts›0‹/successCounts› 
              ‹/returnsms›

返回信息解释

返回信息提示说明
ok提交成功
用户名或密码不能为空提交的用户名或密码为空
发送内容包含sql注入字符包含sql注入字符
用户名或密码错误表示用户名或密码错误
用户名或密码错误表示用户名或密码错误
短信号码不能为空提交的被叫号码为空
短信内容不能为空发送内容为空
包含非法字符:表示检查到不允许发送的非法字符
对不起,您当前要发送的量大于您当前余额当支付方式为预付费是,检查到账户余额不足
其他错误其他数据库操作方面的错误


Demo下载包:
 
   
 
 
 
 
 
 
 
 
 
 
 
 
信息标题:
您的姓名:
联系电话:
反馈内容:
 
  
版权所有:广州掌骏网络科技有限公司     地址:广东省广州市天河区建工路9号302A    电话:020-85533084   传真:020-85533084   粤ICP备17139822号
收起
展开