请求参数
参数名称 | 含义 | 说明 |
---|
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位数。 |
响应参数
名称 | 类型 | 示例 | 描述 |
---|
returnsm | String | | Xml根元素 |
returnstatus | Boolean | Success | 返回状态值:成功返回Success 失败返回:Faild |
message | String | ok | 返回信息描述 |
remainpoint | Int | 123 | 返回余额 |
taskID | Int | 54215257 | 返回本次任务的序列ID |
successCounts | Int | 2 | 成功短信数:当成功后返回提交成功短信数 |
请求示例(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注入字符 |
用户名或密码错误 | 表示用户名或密码错误 |
用户名或密码错误 | 表示用户名或密码错误 |
短信号码不能为空 | 提交的被叫号码为空 |
短信内容不能为空 | 发送内容为空 |
包含非法字符: | 表示检查到不允许发送的非法字符 |
对不起,您当前要发送的量大于您当前余额 | 当支付方式为预付费是,检查到账户余额不足 |
其他错误 | 其他数据库操作方面的错误 |