中国网建SMS短信接口调用（java发送和接收手机短信）

引言

最近有点想写博客的冲动，不为别的，只为能为那些和我一样碰到困难的码农们尽一份绵薄之力，分享技术和心得，探讨疑点，共同学习，共同进步。但提笔时又不知从何作起，java这门语言犹如一部浩瀚的生活字典融入到我们的程序里，需要我们不断的查询、翻阅、演练才行。今天偶然接到公司之前做的项目说要更新里面的短信上行和下发功能，这下我懵了，之前我还没尝试过这方面的开发工作。于是在网络上搜索了一下相应的技术文章，整理并分享给各位。

大概了解到java发送短信的几种：

使用webservice接口发送手机短信,这个可以使用sina提供的webservice进行发送,但是需要进行注册。
使用短信mao的方式进行短信的发送,这种方式应该是比较的常用,前提是需要购买硬件设备。
使用中国网建提供的SMS短信平台（http://sms.webchinese.cn）进行实现。

今天要介绍的是通过SMS短信API实现JAVA语言的短信的下行和上行方法

SMS短信通下行接口

GBK编码发送接口地址：
http://gbk.sms.webchinese.cn/?Uid=本站用户名&Key=接口安全密码&smsMob=手机号码&smsText=短信容

UTF-8编码发送接口地址：
http://utf8.sms.webchinese.cn/?Uid=本站用户名&Key=接口安全密码&smsMob=手机号码&smsText=短信内容

获取短信数量接口地址(UTF8)：
http://sms.webchinese.cn/web_api/SMS/?Action=SMS_Num&Uid=本站用户名&Key=接口安全密码

获取短信数量接口地址(GBK)：

http://sms.webchinese.cn/web_api/SMS/GBK/?Action=SMS_Num&Uid=本站用户名&Key=接口安全密码

请求参数

提示:HTTP调用URL接口时, 参数值必须URL编码后再调用

参数变量	说明
Gbk编码Url	http://gbk.sms.webchinese.cn/
Utf-8编码Url	http://utf8.sms.webchinese.cn/
Uid	SMS短信通用户名（需注册）
Key	注册时填写的接口安全密码（可修改）
smsMob	目的手机号码（多个手机号请用半角逗号隔开）
smsText	短信内容，最多支持300个字，普通短信70个字/条，长短信64个字/条计费

提示：

多个手机号请用半角,隔开如：13888888886,13888888887,1388888888 一次最多对100个手机发送。
短信内容支持长短信，最多300个字，普通短信66个字/条，长短信64个字/条计费

短信发送后返回值	说明
-1	没有该用户账户
-2	密钥不正确
-3	短信数量不足
-11	该用户被禁用
-14	短信内容出现非法字符
-4	手机号格式不正确
-41	手机号码为空
-42	短信内容为空
-51	短信签名格式不正确接口签名格式为：【签名内容】
大于0	短信发送数量

注意：

调用API接口，需登录中国网建SMS短信通平台，申请106网关发送，即发即到！
发送测试短信请勿输入：短信测试等词语，请直接提交您要发送的短信内容；
接口发送短信时请在内容后加签名：【XX公司或XX网名称】，否者会被屏蔽。
短信签名可在用户平台平台上设置，也可以在短信内容后，直接加入。

短信发送核心实现

import java.io.UnsupportedEncodingException;
import org.apache.commons.httpclient.Header;
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;public class SendMsgWebchinese {public static void main(String[] args)throws Exception{HttpClient client = new HttpClient();PostMethod post = new PostMethod("http://gbk.sms.webchinese.cn"); // 在头文件中设置转码post.addRequestHeader("Content-Type","application/x-www-form-urlencoded;charset=gbk");NameValuePair[] data = { new NameValuePair("Uid", "本站用户名"),new NameValuePair("Key", "接口安全密码"),new NameValuePair("smsMob","手机号码"),new NameValuePair("smsText","短信内容")};post.setRequestBody(data);client.executeMethod(post);Header[] headers = post.getResponseHeaders();int statusCode = post.getStatusCode();System.out.println("statusCode:"+statusCode);for(Header h : headers){System.out.println(h.toString());}String result = new String(post.getResponseBodyAsString().getBytes("gbk")); System.out.println(result);post.releaseConnection();}
}

需引用的jar包
commons-logging-1.1.1.jar
commons-httpclient-3.1.jar
commons-codec-1.4.jar

SMS短信通上行接口

短信上行API地址(UTF-8)：
http://sms.webchinese.cn/web_api/SMS/?Action=UP&Uid=本站用户名&Key=接口安全密码&Prompt=0

短信上行API地址(GBK)：

http://sms.webchinese.cn/web_api/SMS/GBK/?Action=UP&Uid=本站用户名&Key=接口安全密码&Prompt=0

API接口只输出3天内回复信息，变量Prompt=1时，输出过的短信回复信息将不再输出。

请求参数

参数变量	说明
Uid	SMS短信通用户名（需注册）
Key	注册时填写的接口安全密码（可修改）
Action	action=UP 输出上行回复信息
Prompt	Prompt=0 下次继续提示，Prompt=1 输出回复下次不提示

页面返回值	说明
-1	没有该用户账户
-2	密钥不正确（不是用户密码）
-11	该用户被禁用
0	没有回复信息

回复信息是XML格式文本，如下：

<?xml version="1.0" encoding="UTF-8" ?><delivers><deliver><mob>138000000002</mob><content>回复2</content><time>2010-01-02 15:26:42</time></deliver><deliver><mob>138000000001</mob><content>回复1</content><time>2010-01-01 15:26:42</time></deliver>...多条回复</delivers>

根据回复内容，可使用XStream处理xml文件并转为java bean对象进行读取！

由此SMS短信上行功能告一段落。