JAVA_美联软通

API文档

代码示例

首页 > API文档 > 云服务器

调用JAVA说明

短信验证码JAVA接口文档下载：点击下载

普通短信发送: 用户在遵循HTTP协议的前提下，可通过GET和POST方式提交短信发送请求
普通短信发送: 短信可以提交不超过50000个手机号码，每个号码用英文逗号间隔。 (一次提交发送超过200个手机号码，请使用POST请求)

乱码问题解决方案：

1、GBK编码提交的首先urlencode短信内容（content），然后在API请求时，带入encode=gbk
2、UTF-8编码的将content 做urlencode编码后，带入encode=utf8或utf-8实例：http://m.5c.com.cn/api/send/index.php?username=XXX&password_md5=XXX&apikey=XXX&mobile=XXX&content=%E4%BD%A0%E5%A5%BD%E6%89%8D%E6%94%B6%E7%9B%8A%E9%9F%A6&encode=utf8

内容转码问题解决方案：

1、 UTF-8 转 GBK：$content = iconv("UTF-8","GBK//IGNORE",$content);
2、 GBK 转 UTF-8：$content = iconv("GBK","UTF-8",$content);

发送接口返回结果

序号	参数	说明
1	success:msgid	提交成功
2	error:Missing username	用户名为空
3	error:Missing password	密码为空
4	error:Missing apikey	APIKEY为空
5	error:Missing recipient	手机号为空
6	error:Missing message content	短信内容为空
7	error:Account is blocked	账号被禁用
8	error:Unrecognized encoding	编码未能识别
9	error:APIKEY or password error	APIKEY或密码错误
10	error:Unauthorized IP address	未授权 IP 地址
11	error:Account balance is insufficient	余额不足

JAVA代码示例：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class sendSMS {
   public static void main(String[] args) {
       //连接超时及读取超时设置
       System.setProperty("sun.net.client.defaultConnectTimeout", "30000"); //连接超时：30秒
       System.setProperty("sun.net.client.defaultReadTimeout", "30000");   //读取超时：30秒
       //新建一个StringBuffer链接
       StringBuffer buffer = new StringBuffer();
       //String encode = "GBK"; //页面编码和短信内容编码为GBK。重要说明：如提交短信后收到乱码，请将GBK改为UTF-8测试。如本程序页面为编码格式为：ASCII/GB2312/GBK则该处为GBK。如本页面编码为UTF-8或需要支持繁体，阿拉伯文等Unicode，请将此处写为：UTF-8
       String encode = "UTF-8";
       String username = ""; //用户名
       String password_md5 = ""; //密码
       String mobile = ""; //手机号,只发一个号码：13800000001。发多个号码：13800000001,13800000002,...N 。使用半角逗号分隔。
       String apikey = ""; //apikey秘钥（请登录 http://m.5c.com.cn 短信平台-->账号管理-->我的信息中复制apikey）
       String content = "您好，您的验证码是：12345【美联】"; //要发送的短信内容，特别注意：签名必须设置，网页验证码应用需要加添加【图形识别码】。
       try {
           String contentUrlEncode = URLEncoder.encode(content,encode); //对短信内容做Urlencode编码操作。注意：如            //把发送链接存入buffer中，如连接超时，可能是您服务器不支持域名解析，请将下面连接中的：【m.5c.com.cn】修改为IP：【115.28.23.78】
           buffer.append("http://m.5c.com.cn/api/send/index.php?username="+username+"&password_md5="+password_md5+"&mobile="+mobile+"&apikey="+apikey+"&content="+contentUrlEncode+"&encode="+encode);
           //System.out.println(buffer); //调试功能，输入完整的请求URL地址
           URL url = new URL(buffer.toString()); //把buffer链接存入新建的URL中
           HttpURLConnection connection = (HttpURLConnection)url.openConnection();   //打开URL链接
           connection.setRequestMethod("POST"); //使用POST方式发送
           connection.setRequestProperty("Connection", "Keep-Alive");    //使用长链接方式
           BufferedReader reader = new BufferedReader(new InputStreamReader(url.openStream()));    //发送短信内容
           String result = reader.readLine();//获取返回值
           System.out.println(result); //输出result内容，查看返回值，成功为success，错误为error，详见该文档起始注释
       } catch (Exception e) {
           e.printStackTrace();
       }
   }
}