Google App Engine 飞信ＡＰＩ接口
Google App Engine 飞信ＡＰＩ接口
网页版飞信：https://fetionlib.appspot.com/
Google App Engine 飞信ＡＰＩ接口
package com.test;
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.util.UUID;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.json.JSONArray;
import org.json.JSONObject;
/**
*@author Terry Email: yaoxinghuo at 126 dot com
*@version create: Aug 5, 2009 11:17:23 AM
*@version update: Oct 15, 2009 00:11:00 AM
*@description 飞信API(fetionlib) HTTP简单调用举例 另有Restlet的方式可供调用。网页版飞信首页:https://fetionlib.appspot.com/
* 小提示：免费开通飞信：如果您的手机号没有开通飞信，可以到中国移动飞信网站查看开通，或者直接编辑短信KTFX发送到10086开通
* 修改飞信密码：手机编辑新密码（6到16位，不能是中文或全角字符）内容发送到12520050
* 直接在浏览器里输入以下地址（您的手机号码和密码请自行更改，密码不要包含/，朋友号码请填写自己的手机号码）：
* https://fetionlib.appspot.com/restlet/fetion/13812345678/password/13912345678/message
* 以上四个用/隔开的加粗的地方，应该分别替换成：您的手机号、密码、对方手机号（可以写自己的手机号发给自己）、短信内容（不超过180字），
* 如果是密码错误，没有开通飞信，对方不是您好友等原因不能发送都是返回提示Message Not Sent，只有成功返回OK
* 如果要发送中文，最好用URLEncode（UTF-8编码，如“你好”Encode后为%E4%BD%A0%E5%A5%BD，现已支持）或后面举的例子（POST方式，注意调用的URL略有不同）
* 如果您可以收到自己发给自己的短信，恭喜您，测试通过，你可以用您熟悉的语言通过POST或GET调用，调用格式请看下面Java例子，其他语言类似
* 如有疑问或对API的接口调用方式有任何更好的建议，欢迎提出宝贵意见
*
* 现已经更新支持取得好友列表、POST方式的群发(8个或8个以下好友)和定时发送群发(定时群发最多30个好友)，请看更新的例子
*
* 更新近期发现有人利用本程序给他人发送轰炸短信，给他人造成严重骚扰，同时也大量消耗本站资源，已作如下限制：
* 同一个手机号给同一个好友的发短信API以及其他的API（如：添加好友、获取好友列表等）请求间隔为30秒，30秒内的类似请求将无法完成。
* 注：考虑到实际需要，给自己发送短信（手机号和对方好友号码相同或者群发好友里面包含自己手机号）的API请求将不会有30秒时间间隔的限制！
*
* 本飞信API接口程序由Google强力驱动、免费托管，将长期保留，示例程序用到的json包，请到www.json.org下载jar包，也可到这里下载
*/
public class Test {
private static Log log = LogFactory.getLog(Test.class);
public static void main(String[] args) {
//测试发短信，注意：相同手机号，相同好友的请求的调用间隔要超过30秒(除非好友中包含你自己的手机号)，否则不成功（responseCode:406）
boolean b = fetchToSendSMS("13812345678", "12345678", new String[] { "13812345678" },
"TestMessage");
System.out.println("Send Message result:" + b);
//测试取得好友列表
// JSONArray friends = fetchToGetFriends("13812345678", "12345678");
// System.out.println("friends:\r\n"+ (friends == null ? "null" : friends.toString()));
//测试添加好友
// int result = fetchToAddFriend("13812345678", "12345678","13812345678","TestMyName", "TestFriendName");
// System.out.println("Add Friend result:"+result);
//测试发送定时短信(注意是太平洋时间，所以2009-10-09 01:00 是北京时间09:00发奥)
// String sid = fetchToSendScheduleMsg("13812345678", "12345678", new String[]{"13912345678"}, "TestScheduleMessage", "2009-10-09 01:00");
// System.out.println("sid:"+sid);
//测试删除定时短信
// boolean b2 = fetchToDeleteScheduleMsg("13812345678", "12345678", new String[]{"aglmZXRpb25saWJyGgsSB0FjY291bnQYAQwLEgdNZXNzYWdlGCQM")};
// System.out.println("schedule message delete result:"+b2);
}
private static final int TRY_TIMES = 3;
private static final int TIME_OUT = 30000;
/**
*发送短消息 更简单的Get方式（不支持群发，如要群发用下面POST方式，已更新），直接在浏览器里输入以下地址,手机号码和密码请自行改掉：
* https://fetionlib.appspot.com/restlet/fetion/13812345678/password/13912345678/message 成功返回OK
* 否则返回Message Not Sent，如果要群发或者您的密码包含/或者需要提交中文消息避免可能的乱码最好请用以下的程序（POST方式）
*@param friends
* 短信接收方的好友们
* 注意参数String[] friends 中的数组可以是好友的手机号,也可以是后面用程序取到的好友的uri，详见后面取得好友列表的说明
* 如 fetchToSendSMS("13812345678","password",new String[]{"sip:[email protected];p=5065","13916416465","tel:15912345678"},"Test");
* 好友数不能超过8个，如果有需要，请用程序分开来多次调用
* 注意：相同手机号，相同好友的请求的调用间隔要超过30秒，否则不成功（responseCode:406），但接受好友中包含你自己的手机号的请求不受30秒的限制！
*@param message
* 短信内容，字数不能超过180字
*/
public static boolean fetchToSendSMS(String mobile, String password,
String[] friends, String message) {
// 加上UUID的目的是防止这样的情况，在服务器上已经成功发送短信，却在返回结果过程中遇到错误，
// 而导致客户端继续尝试请求，此时让服务器根据UUID分辨出该请求已经发送过，避免再次发送短信。
String uuid = UUID.randomUUID().toString();
for (int i = 0; i < TRY_TIMES; i++) {
int responseCode = 0;
try {
URL postUrl = new URL(
"https://fetionlib.appspot.com/restlet/fetion");
HttpURLConnection connection = (HttpURLConnection) postUrl
.openConnection();
connection.setConnectTimeout(TIME_OUT);
connection.setReadTimeout(TIME_OUT);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setUseCaches(false);
connection.setInstanceFollowRedirects(true);
connection.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
connection.connect();
DataOutputStream out = new DataOutputStream(connection
.getOutputStream());
String content = "mobile=" + mobile + "&uuid=" + uuid
+ "&password=" + password + "&friend=" + convertArrayToJSONString(friends)
+ "&message=" + URLEncoder.encode(message, "utf-8");
out.writeBytes(content);
out.flush();
out.close();
responseCode = connection.getResponseCode();
connection.disconnect();
if (responseCode == 202)
return true;
else
return false;
} catch (Exception e) {
log.warn("error fetchToSendSMS, exception:" + e.getMessage()
+ ". tried " + i + " times");
}
}
return false;
}
/**
*取得好友列表 GET方式为：
* https://fetionlib.appspot.com/restlet/fetion/friendsList/13812345678/password
* 成功将返回JSON格式的好友列表，如果您不了解JSON格式，请先网上查阅相关知识，
* 如：[{"nickname":"Jerry","localname":"小张","uri":"sip:[email protected];p=6012","mobile":"13912345678"}]
* 其中nickname是对方给自己设置的昵称，localname是您给对方设置的名字，mobile是对方公开的手机号，uri是该用户的标识符，可用于发送短信时传递的参数
* 注意nickname、localname、mobile 这三个字段可能为空，如果为空，将不会再JSON中显示！
* 不成功返回空白
* 注意：相同手机号调用间隔要超过30秒，否则不成功（responseCode:406）
*
* 您从JSONArray中取得的uri,如sip:[email protected];p=6012或可能为tel:13912345678，
* 可直接作为参数传入上面的例子中发送短信， 如果有mobile，也可以传入mobile如13916416465，
* 不过有些时候，对方不公开手机号，便无法获取手机号，只有通过uri来发送短信
*
*/
public static JSONArray fetchToGetFriends(String mobile, String password) {
String uuid = UUID.randomUUID().toString();
for (int i = 0; i < TRY_TIMES; i++) {
try {
URL postUrl = new URL(
"https://fetionlib.appspot.com/restlet/fetion/friendsList");
HttpURLConnection connection = (HttpURLConnection) postUrl
.openConnection();
connection.setConnectTimeout(TIME_OUT);
connection.setReadTimeout(TIME_OUT);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setUseCaches(false);
connection.setInstanceFollowRedirects(true);
connection.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
connection.connect();
DataOutputStream out = new DataOutputStream(connection
.getOutputStream());
String content = "mobile=" + mobile + "&uuid=" + uuid
+ "&password=" + password;
out.writeBytes(content);
out.flush();
out.close();
int responseCode = connection.getResponseCode();
if (responseCode == 202) {
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream())); // 读取结果
StringBuffer sb = new StringBuffer();
String line;
while ((line = reader.readLine()) != null) {
sb.append(line);
}
reader.close();
connection.disconnect();
return new JSONArray(sb.toString());
} else {
connection.disconnect();
}
} catch (Exception e) {
log.warn("error fetchToGetFriends, exception:" + e.getMessage()
+ ". tried " + i + " times");
}
}
return null;
}
/**
*邀请好友 GET方式为：
* https://fetionlib.appspot.com/restlet/fetion/friend/13812345678/password/13912345678/MyName/FriendNickname 返回数字-1或0或1，见下面说明
*
*@param friend
* 被邀请好友的手机号
*@param desc
* 您的姓名（不能超过5个字），对方收到邀请短信时，会显示这个名字，以便让对方知道您是谁
*@param nickname
* 对方的姓名（不能超过10个字），如果对方同意的话，这个名字会作为您的好友名称显示
*
*@return -1错误或者对方手机号不支持, 0对方已经是您的好友 1成功发送邀请短信，等待对方回复是否同意
* 注意：相同手机号调用间隔要超过30秒，否则不成功（responseCode:406）
*/
public static int fetchToAddFriend(String mobile, String password,
String friend, String desc, String nickname) {
String uuid = UUID.randomUUID().toString();
for (int i = 0; i < TRY_TIMES; i++) {
int responseCode = 0;
try {
URL postUrl = new URL(
"https://fetionlib.appspot.com/restlet/fetion/friend");
HttpURLConnection connection = (HttpURLConnection) postUrl
.openConnection();
connection.setConnectTimeout(TIME_OUT);
connection.setReadTimeout(TIME_OUT);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setUseCaches(false);
connection.setInstanceFollowRedirects(true);
connection.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
connection.connect();
DataOutputStream out = new DataOutputStream(connection
.getOutputStream());
String content = "mobile=" + mobile + "&uuid=" + uuid
+ "&password=" + password + "&friend=" + friend
+ "&desc=" + URLEncoder.encode(desc, "utf-8")
+ "&nickname=" + URLEncoder.encode(nickname, "utf-8");
out.writeBytes(content);
out.flush();
out.close();
responseCode = connection.getResponseCode();
if (responseCode == 202) {
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream())); // 读取结果
StringBuffer sb = new StringBuffer();
String line;
while ((line = reader.readLine()) != null) {
sb.append(line);
}
reader.close();
connection.disconnect();
JSONObject jo = new JSONObject(sb.toString());
return jo.getInt("action");
} else {
connection.disconnect();
return -1;
}
} catch (Exception e) {
log.warn("error fetchToAddFriend, exception:" + e.getMessage()
+ ". tried " + i + " times");
}
}
return -1;
}
/**
*发送定时短信 GET方式为（不支持群发，如要群发用下面POST方式，已更新）:
* https://fetionlib.appspot.com/restlet/fetion/schedule/13812345678/password/13912345678/message/2009-08-08%2012:18 成功返回sid号码，否则返回空白(空格)
*
*POST方式如下
*
*@param message
* 短信内容，字数不能超过180字
*@param date
* 发送日期格式为yyyy-MM-dd HH:mm，注意日期为时区为0的标准时间，北京时间的时区是8，所以要减去8小时；
* 如计划2009-08-08 20:18分发送，应该填写2009-08-08 12:18；
* 中国移动还规定日期要超出现在时间20分钟但不能超过1年。
*@param friends
* 接受短信的好友们，其中的数组可以是好友的手机号,也可以是用程序取到的好友的uri，注意好友数不能超过30个，如果有需要，请用程序分开来多次调用
* 注意：相同手机号，相同好友的请求的调用间隔要超过30秒，否则不成功（responseCode:406），但接受好友中包含你自己的手机号的请求不受30秒的限制！
*
*@return 一个sid号码，记下来如果后续要撤销短信发送，需要用到这个号码
*/
public static String fetchToSendScheduleMsg(String mobile, String password,
String[] friends, String message, String date) {
String uuid = UUID.randomUUID().toString();
for (int i = 0; i < TRY_TIMES; i++) {
try {
URL postUrl = new URL(
"https://fetionlib.appspot.com/restlet/fetion/schedule");
HttpURLConnection connection = (HttpURLConnection) postUrl
.openConnection();
connection.setConnectTimeout(TIME_OUT);
connection.setReadTimeout(TIME_OUT);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setUseCaches(false);
connection.setInstanceFollowRedirects(true);
connection.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
connection.connect();
DataOutputStream out = new DataOutputStream(connection
.getOutputStream());
String content = "mobile=" + mobile + "&uuid=" + uuid
+ "&password=" + password + "&friend=" + convertArrayToJSONString(friends)
+ "&schedule=" + date.replace(" ", "%20") + "&message="
+ URLEncoder.encode(message, "utf-8");
out.writeBytes(content);
out.flush();
out.close();
int responseCode = connection.getResponseCode();
if (responseCode == 202) {
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream())); // 读取结果
StringBuffer sb = new StringBuffer();
String line;
while ((line = reader.readLine()) != null) {
sb.append(line);
}
reader.close();
connection.disconnect();
JSONObject jo = new JSONObject(sb.toString());
return jo.getString("sid");
} else {
connection.disconnect();
return null;
}
} catch (Exception e) {
log.warn("error fetchToSaveSchedule, exception:"
+ e.getMessage() + ". tried " + i + " times");
}
}
return null;
}
/**
*删除定时短信 GET方式为：
* https://fetionlib.appspot.com/restlet/fetion/scheduleDelete/13812345678/password/aglmZXRpb25saWJyGgsSB0FjY291bnQYAQwLEgdNZXNzYWdlGCQM
* aglmZXRpb25saWJyGgsSB0FjY291bnQYAQwLEgdNZXNzYWdlGCQM是你发送定时短信返回的sid号码，
* GET方式之支持一次删除一个定时短信，如果要删除多个，请用下面的POST方式，成功返回OK，否则返回Schedule Not Deleted
* 注意：相同手机号调用间隔要超过30秒，否则不成功（responseCode:406）
*
*@param sid
* 发送定时短信时返回的那些sid号码（不能超过10个sid），多个用数组的形式，程序会转换成JSON提交
*
*/
public static boolean fetchToDeleteScheduleMsg(String mobile,
String password, String[] sids) {
String uuid = UUID.randomUUID().toString();
for (int i = 0; i < TRY_TIMES; i++) {
try {
URL postUrl = new URL(
"https://fetionlib.appspot.com/restlet/fetion/scheduleDelete");
HttpURLConnection connection = (HttpURLConnection) postUrl
.openConnection();
connection.setConnectTimeout(TIME_OUT);
connection.setReadTimeout(TIME_OUT);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setUseCaches(false);
connection.setInstanceFollowRedirects(true);
connection.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
connection.connect();
DataOutputStream out = new DataOutputStream(connection
.getOutputStream());
String content = "mobile=" + mobile + "&uuid=" + uuid
+ "&password=" + password + "&sids="
+ convertArrayToJSONString(sids);
out.writeBytes(content);
out.flush();
out.close();
int responseCode = connection.getResponseCode();
connection.disconnect();
if (responseCode == 202)
return true;
else
return false;
} catch (Exception e) {
log.warn("error fetchToDeleteSchedule, exception:"
+ e.getMessage() + ". tried " + i + " times");
}
}
return false;
}
//把数组转化成JSONString
private static String convertArrayToJSONString(String[] arr) throws Exception {
JSONArray ja = new JSONArray();
for (String a : arr)
ja.put(a);//ja.add(a);//?
return URLEncoder.encode(ja.toString(), "UTF-8");
}
}
