一、微信消息分組群發接口簡介
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方法請求體里面發送給服務器端。
三、代碼實現
1 package com.demo.test; 2 3 import java.io.File; 4 import java.util.ArrayList; 5 import java.util.HashMap; 6 import java.util.List; 7 import java.util.Map; 8 9 import org.apache.commons.httpclient.methods.PostMethod; 10 import org.apache.commons.httpclient.methods.multipart.FilePart; 11 import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity; 12 import org.apache.commons.httpclient.methods.multipart.Part; 13 import org.apache.http.HttpEntity; 14 import org.apache.http.HttpResponse; 15 import org.apache.http.HttpStatus; 16 import org.apache.http.client.HttpClient; 17 import org.apache.http.client.methods.HttpGet; 18 import org.apache.http.impl.client.DefaultHttpClient; 19 import org.apache.http.util.EntityUtils; 20 21 import com.google.gson.Gson; 22 import com.google.gson.JsonArray; 23 import com.google.gson.JsonObject; 24 import com.google.gson.JsonParser; 25 26 public class Test 27 { 28 public static final String GET_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token";// 獲取access 29 public static final String UPLOAD_IMAGE_URL = "http://file.api.weixin.qq.com/cgi-bin/media/upload";// 上傳多媒體文件 30 public static final String UPLOAD_FODDER_URL = "https://api.weixin.qq.com/cgi-bin/media/uploadnews"; 31 public static final String GET_USER_GROUP = "https://api.weixin.qq.com/cgi-bin/groups/get"; // url 32 public static final String SEND_MESSAGE_URL = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall"; 33 public static final String APP_ID = "wxa549b28c24cf341e"; 34 public static final String SECRET = "78d8a8cd7a4fa700142d06b96bf44a37"; 35 36 37 /** 38 * 發送消息 39 * 40 * @param uploadurl 41 * apiurl 42 * @param access_token 43 * @param data 44 * 發送數據 45 * @return 46 */ 47 public static String sendMsg(String url, String token, String data) 48 { 49 org.apache.commons.httpclient.HttpClient client = new org.apache.commons.httpclient.HttpClient(); 50 String sendurl = String.format("%s?access_token=%s", url, token); 51 PostMethod post = new UTF8PostMethod(sendurl); 52 post 53 .setRequestHeader( 54 "User-Agent", 55 "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"); 56 57 post.setRequestHeader("Host", "file.api.weixin.qq.com"); 58 post.setRequestHeader("Connection", "Keep-Alive"); 59 post.setRequestHeader("Cache-Control", "no-cache"); 60 String result = null; 61 try 62 { 63 post.setRequestBody(data); 64 int status = client.executeMethod(post); 65 if (status == HttpStatus.SC_OK) 66 { 67 String responseContent = post.getResponseBodyAsString(); 68 System.out.println(responseContent); 69 JsonParser jsonparer = new JsonParser();// 初始化解析json格式的對象 70 JsonObject json = jsonparer.parse(responseContent) 71 .getAsJsonObject(); 72 if (json.get("errcode") != null 73 && json.get("errcode").getAsString().equals("0")) 74 { 75 result = json.get("errmsg").getAsString(); 76 } 77 } 78 } 79 catch (Exception e) 80 { 81 e.printStackTrace(); 82 } 83 finally 84 { 85 return result; 86 } 87 } 88 89 public static class UTF8PostMethod extends PostMethod {//防止發送的消息產生亂碼 90 public UTF8PostMethod(String url) { 91 super(url); 92 } 93 94 @Override 95 public String getRequestCharSet() {//文本編碼格式 96 return "UTF-8"; 97 } 98 } 99 100 public static void main(String[] args) throws Exception 101 { 102 String accessToken = getToken(GET_TOKEN_URL, APP_ID, SECRET);// 獲取token在微信接口之一中獲取 103 if (accessToken != null)// token成功獲取 104 { 105 System.out.println(accessToken); 106 File file = new File("f:" + File.separator + "2000.JPG"); // 獲取本地文件 107 String id = uploadImage(UPLOAD_IMAGE_URL, accessToken, "image", 108 file);// java微信接口之三—上傳多媒體文件 可獲取 109 if (id != null) 110 { 111 // 構造數據 112 Map map = new HashMap(); 113 map.put("thumb_media_id", id); 114 map.put("author", "wxx"); 115 map.put("title", "標題"); 116 map.put("content", "測試fdsfdsfsdfssfdsfsdfsdfs"); 117 map.put("digest", "digest"); 118 map.put("show_cover_pic", "0"); 119 120 Map map2 = new HashMap(); 121 map2.put("thumb_media_id", id); 122 map2.put("author", "wxx"); 123 map2.put("content_source_url", "www.google.com"); 124 map2.put("title", "標題"); 125 map2.put("content", "測試fdsfdsfsdfssfdsfsdfsdfs"); 126 map2.put("digest", "digest"); 127 128 Map map3 = new HashMap(); 129 List<Map> list = new ArrayList<Map>(); 130 list.add(map); 131 list.add(map2); 132 map3.put("articles", list); 133 134 Gson gson = new Gson(); 135 String result = gson.toJson(map3);// 轉換成json數據格式 136 String mediaId = uploadFodder(UPLOAD_FODDER_URL, accessToken, 137 result); 138 if (mediaId != null) 139 { 140 String ids = getGroups(GET_USER_GROUP, accessToken);// 在java微信接口之二—獲取用戶組 141 if (ids != null) 142 { 143 String[] idarray = ids.split(",");// 用戶組id數組 144 for (String gid : idarray) 145 { 146 147 JsonObject jObj = new JsonObject(); 148 JsonObject filter = new JsonObject(); 149 filter.addProperty("group_id", gid); 150 jObj.add("filter", filter); 151 152 153 JsonObject mpnews = new JsonObject(); 154 mpnews.addProperty("media_id", mediaId); 155 jObj.add("mpnews", mpnews); 156 157 jObj.addProperty("msgtype", "mpnews"); 158 System.out.println(jObj.toString()); 159 160 String result2 = sendMsg(SEND_MESSAGE_URL, 161 accessToken, jObj.toString()); 162 System.out.println(result2); 163 } 164 } 165 } 166 167 } 168 } 169 } 170 }
發成功后會打印消息,但由於微信服務器的原因,消息不會立即發送,會過一段時間發送。