一、微信消息分组群发接口简介
1、请求:该请求是使用post提交地址为:
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
其中ACCESS_TOKEN是我们动态获取的。
发送的数据:(这里使用图文消息示例)
{
"filter":{
"group_id":"2"
},
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}
filter,用于设定图文消息的接收者;
group_id,群发到的分组的group_id(可在java微信接口之二—获取用户组);
mpnews,用于设定即将发送的图文消息;
media_id, 用于群发的消息的media_id(可在java微信接口之四—上传素材中获取); msgtype,群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video.
2、响应:该响应也是以json方式返回的
正确的时候返回的数据:
{
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182
}
errcode 错误码
errmsg 错误信息
msg_id 消息ID
错误的时候返回的数据:{"errcode":40004,"errmsg":"invalid media type"}
errcode,为错误代码,errmsg为错误信息
具体api可查看:http://mp.weixin.qq.com/wiki/index.php?title=%E9%AB%98%E7%BA%A7%E7%BE%A4%E5%8F%91%E6%8E%A5%E5%8F%A3
二、关于java代码的调用
该接口的调用与java微信接口四—上传素材一样,需要使用到commons-httpclient。其中数据是构造成json数据后,放在post方法请求体里面发送给服务器端。
三、代码实现
package com.demo.test; import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map; import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity;
import org.apache.commons.httpclient.methods.multipart.Part;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils; import com.google.gson.Gson;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser; public class Test
{
public static final String GET_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token";// 获取access
public static final String UPLOAD_IMAGE_URL = "http://file.api.weixin.qq.com/cgi-bin/media/upload";// 上传多媒体文件
public static final String UPLOAD_FODDER_URL = "https://api.weixin.qq.com/cgi-bin/media/uploadnews";
public static final String GET_USER_GROUP = "https://api.weixin.qq.com/cgi-bin/groups/get"; // url
public static final String SEND_MESSAGE_URL = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall";
public static final String APP_ID = "wxa549b28c24cf341e";
public static final String SECRET = "78d8a8cd7a4fa700142d06b96bf44a37"; /**
* 发送消息
*
* @param uploadurl
* apiurl
* @param access_token
* @param data
* 发送数据
* @return
*/
public static String sendMsg(String url, String token, String data)
{
org.apache.commons.httpclient.HttpClient client = new org.apache.commons.httpclient.HttpClient();
String sendurl = String.format("%s?access_token=%s", url, token);
PostMethod post = new UTF8PostMethod(sendurl);
post
.setRequestHeader(
"User-Agent",
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"); post.setRequestHeader("Host", "file.api.weixin.qq.com");
post.setRequestHeader("Connection", "Keep-Alive");
post.setRequestHeader("Cache-Control", "no-cache");
String result = null;
try
{
post.setRequestBody(data);
int status = client.executeMethod(post);
if (status == HttpStatus.SC_OK)
{
String responseContent = post.getResponseBodyAsString();
System.out.println(responseContent);
JsonParser jsonparer = new JsonParser();// 初始化解析json格式的对象
JsonObject json = jsonparer.parse(responseContent)
.getAsJsonObject();
if (json.get("errcode") != null
&& json.get("errcode").getAsString().equals("0"))
{
result = json.get("errmsg").getAsString();
}
}
}
catch (Exception e)
{
e.printStackTrace();
}
finally
{
return result;
}
} public static class UTF8PostMethod extends PostMethod {//防止发送的消息产生乱码
public UTF8PostMethod(String url) {
super(url);
} @Override
public String getRequestCharSet() {//文本编码格式
return "UTF-8";
}
} public static void main(String[] args) throws Exception
{
String accessToken = getToken(GET_TOKEN_URL, APP_ID, SECRET);// 获取token在微信接口之一中获取
if (accessToken != null)// token成功获取
{
System.out.println(accessToken);
File file = new File("f:" + File.separator + "2000.JPG"); // 获取本地文件
String id = uploadImage(UPLOAD_IMAGE_URL, accessToken, "image",
file);// java微信接口之三—上传多媒体文件 可获取
if (id != null)
{
// 构造数据
Map map = new HashMap();
map.put("thumb_media_id", id);
map.put("author", "wxx");
map.put("title", "标题");
map.put("content", "测试fdsfdsfsdfssfdsfsdfsdfs");
map.put("digest", "digest");
map.put("show_cover_pic", "0"); Map map2 = new HashMap();
map2.put("thumb_media_id", id);
map2.put("author", "wxx");
map2.put("content_source_url", "www.google.com");
map2.put("title", "标题");
map2.put("content", "测试fdsfdsfsdfssfdsfsdfsdfs");
map2.put("digest", "digest"); Map map3 = new HashMap();
List<Map> list = new ArrayList<Map>();
list.add(map);
list.add(map2);
map3.put("articles", list); Gson gson = new Gson();
String result = gson.toJson(map3);// 转换成json数据格式
String mediaId = uploadFodder(UPLOAD_FODDER_URL, accessToken,
result);
if (mediaId != null)
{
String ids = getGroups(GET_USER_GROUP, accessToken);// 在java微信接口之二—获取用户组
if (ids != null)
{
String[] idarray = ids.split(",");// 用户组id数组
for (String gid : idarray)
{ JsonObject jObj = new JsonObject();
JsonObject filter = new JsonObject();
filter.addProperty("group_id", gid);
jObj.add("filter", filter); JsonObject mpnews = new JsonObject();
mpnews.addProperty("media_id", mediaId);
jObj.add("mpnews", mpnews); jObj.addProperty("msgtype", "mpnews");
System.out.println(jObj.toString()); String result2 = sendMsg(SEND_MESSAGE_URL,
accessToken, jObj.toString());
System.out.println(result2);
}
}
} }
}
}
}
发成功后会打印消息,但由于微信服务器的原因,消息不会立即发送,会过一段时间发送。