请求参数
| 参数名称 | 含义 | 说明 |
|---|
| 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注入字符 |
| 用户名或密码错误 | 表示用户名或密码错误 |
| 用户名或密码错误 | 表示用户名或密码错误 |
| 短信号码不能为空 | 提交的被叫号码为空 |
| 短信内容不能为空 | 发送内容为空 |
| 包含非法字符: | 表示检查到不允许发送的非法字符 |
| 对不起，您当前要发送的量大于您当前余额 | 当支付方式为预付费是，检查到账户余额不足 |
| 其他错误 | 其他数据库操作方面的错误 |
