请求地址:
http://sms.izjun.cn/v2sms.aspx
http://sms.izjun.cn/v2smsGBK.aspx
请求参数
参数名称 | 含义 | 说明 |
---|
userid | 企业id | class="cs_zc"企业ID |
timestamp | 时间戳 | 系统当前时间字符串,年月日时分秒,例如:20120701231212 |
sign | 签名 | 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写 例如: 账号是test 密码是mima 时间戳是20120701231212 就需要用testmima20120701231212 来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1 其他参数没错的话,提示错误的时候检查加密结果对不对。 |
action | 任务名称 | 设置为固定的:overage |
响应参数
名称 | 类型 | 示例 | 描述 |
---|
returnsm | String |
| Xml根元素 |
returnstatus | Boolean | Success | 返回状态值:成功返回Success 失败返回:Faild |
message | String | ok | 返回信息描述 |
payinfo String | 预付费 | 返回支付方式。 | 后付费,预付费 |
overage | Int | 54215257 | 返回余额 |
sendTotal | Int | 2 | 返回总点数。当支付方式为预付费是返回总充值点数 |
请求示例(c#)
public string Balance(string userid, string timestamp, string sgin)
{
string requestUrl = string.Format("{0}/v2sms.aspx", SITEURL);
StreamReader reader=null;
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 = 10000000;
StringBuilder data = new StringBuilder();
data.Append("action=overage");
data.Append(String.Format("&userid={0}",userid));
data.Append(String.Format("×tamp={0}",timestamp));
data.Append(String.Format("&sign={0}",sgin));
byte[] byteData = UTF8Encoding.UTF8.GetBytes(data.ToString());
request.ContentLength = byteData.Length;
Stream stream = request.GetRequestStream();
stream.Write(byteData,0,byteData.Length);
stream.Close();
WebResponse response = (HttpWebResponse)request.GetResponse();
reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
String value = reader.ReadToEnd();
return value;
}
响应示例
‹?xml version="1.0" encoding="utf-8" ?›
‹returnsms›
‹returnstatus›status‹/returnstatus›
‹message›message‹/message›
‹payinfo›payinfo‹/payinfo›
‹overage›overage‹/overage›
‹sendTotal›sendTotal‹/sendTotal›
‹/returnsms›
异常示例
‹?xml version="1.0" encoding="utf-8" ?›
‹returnsms›
‹returnstatus›‹Faild/returnstatus›
‹message›‹签名错误/message›
‹payinfo›‹/payinfo›
‹overage›‹/overage›
‹sendTotal›‹/sendTotal›
‹/returnsms›
返回信息解释
返回信息提示 | 说明 |
---|
返回空 | 查询成功 将返回相应的支付方式、账户使用条数、总充值点数 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
用户名或密码错误 | 表示用户名或密码错误 |