From 155ce4aba49bb16d0de96eda50ea975d3008fa50 Mon Sep 17 00:00:00 2001 From: ANDRU-PC\Andru <769883346@qq.com> Date: 星期四, 11 八月 2022 17:53:18 +0800 Subject: [PATCH] 添加对接企业微信标签接口 --- src/main/java/com/hx/mp/util/CorpMpClientUtil.java | 214 ++++++++++++++++++++++++++++++++++------------------- 1 files changed, 137 insertions(+), 77 deletions(-) diff --git a/src/main/java/com/hx/mp/util/CorpMpClientUtil.java b/src/main/java/com/hx/mp/util/CorpMpClientUtil.java index 41d7cf7..32d0670 100644 --- a/src/main/java/com/hx/mp/util/CorpMpClientUtil.java +++ b/src/main/java/com/hx/mp/util/CorpMpClientUtil.java @@ -8,121 +8,181 @@ import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; -import java.text.MessageFormat; /** * 浼佷笟寰俊瀹㈡埛宸ュ叿 */ public class CorpMpClientUtil { - /**鐢熸垚鑱旂郴鎴戞寜閽弬鏁扮殑閾炬帴锛堢敓鎴恈onfig_id锛�*/ - public static final String CREATE_CONTACT_ID_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token="; - /**鑾峰彇浼佷笟瀹㈡埛璇︽儏閾炬帴*/ - public static final String GET_CLIENT_DETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get"; - /**娣诲姞瀹㈡埛鑱旂郴浜烘爣绛�*/ - public static final String ADD_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token="; - /**鍒犻櫎瀹㈡埛鑱旂郴浜烘爣绛�*/ - public static final String DEL_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_corp_tag?access_token="; - /**瀹㈡埛鍏宠仈浼佷笟寰俊鐨勬爣绛緐rl*/ - public static final String RELATION_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token="; - - - /**鐢熸垚浼佷笟鎴愬憳鑱旂郴鎴戠殑id-鍗曚汉 - * @param accessToken 浼佷笟鐨刟ccessToken - * @param userId 浼佷笟鎴愬憳鐨剈serId - * @param state 浼佷笟鑷畾涔夌殑state鍙傛暟锛岀敤浜庡尯鍒嗕笉鍚岀殑娣诲姞娓犻亾锛屽湪璋冪敤鈥滆幏鍙栧閮ㄨ仈绯讳汉璇︽儏鈥濇椂浼氳繑鍥炶鍙傛暟鍊硷紝涓嶈秴杩�30涓瓧绗� - * @param remark 鑱旂郴鏂瑰紡鐨勫娉ㄤ俊鎭紝鐢ㄤ簬鍔╄锛屼笉瓒呰繃30涓瓧绗� - * @return + /** + * 鐢熸垚鑱旂郴鎴戞寜閽弬鏁扮殑閾炬帴锛堢敓鎴恈onfig_id锛� */ - public static JSONObject createContactId(String accessToken,String userId,String state,String remark){ + public static final String CREATE_CONTACT_ID_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token="; + /** + * 鑾峰彇浼佷笟瀹㈡埛璇︽儏閾炬帴 + */ + public static final String GET_CLIENT_DETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get"; + /** + * 鑾峰彇鑾峰彇浼佷笟鏍囩搴撻摼鎺� + */ + public static final String GET_CORP_TAG_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token="; + /** + * 娣诲姞瀹㈡埛鑱旂郴浜烘爣绛� + */ + public static final String ADD_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token="; + /** + * 缂栬緫浼佷笟瀹㈡埛鏍囩 + */ + public static final String EDIT_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/edit_corp_tag?access_token="; + /** + * 鍒犻櫎瀹㈡埛鑱旂郴浜烘爣绛� + */ + public static final String DEL_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_corp_tag?access_token="; + /** + * 瀹㈡埛鍏宠仈浼佷笟寰俊鐨勬爣绛緐rl + */ + public static final String RELATION_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token="; - String configId = null; - JSONObject data = new JSONObject(); - data.put("type",1); - data.put("scene",1); - data.put("state",state); - data.put("remark",remark); - JSONArray userIds = new JSONArray(); - userIds.add(userId); - data.put("user",userIds); - //璇锋眰锛岃繑鍥炴牸寮� + /** + * 鐢熸垚浼佷笟鎴愬憳鑱旂郴鎴戠殑id-鍗曚汉 + * + * @param accessToken 浼佷笟鐨刟ccessToken + * @param userId 浼佷笟鎴愬憳鐨剈serId + * @param state 浼佷笟鑷畾涔夌殑state鍙傛暟锛岀敤浜庡尯鍒嗕笉鍚岀殑娣诲姞娓犻亾锛屽湪璋冪敤鈥滆幏鍙栧閮ㄨ仈绯讳汉璇︽儏鈥濇椂浼氳繑鍥炶鍙傛暟鍊硷紝涓嶈秴杩�30涓瓧绗� + * @param remark 鑱旂郴鏂瑰紡鐨勫娉ㄤ俊鎭紝鐢ㄤ簬鍔╄锛屼笉瓒呰繃30涓瓧绗� + * @return 杩斿洖 + */ + public static JSONObject createContactId(String accessToken, String userId, String state, String remark) { + + String configId = null; + JSONObject data = new JSONObject(); + data.put("type", 1); + data.put("scene", 1); + data.put("state", state); + data.put("remark", remark); + JSONArray userIds = new JSONArray(); + userIds.add(userId); + data.put("user", userIds); + + //璇锋眰锛岃繑鍥炴牸寮� /*{ "errcode": 0, "errmsg": "ok", "config_id":"42b34949e138eb6e027c123cba77fAAA"銆�銆� }*/ - return HttpURLUtil(CREATE_CONTACT_ID_URL+accessToken,data.toString()); - } + return HttpURLUtil(CREATE_CONTACT_ID_URL + accessToken, data.toString()); + } - /**鑾峰彇浼佷笟瀹㈡埛璇︽儏淇℃伅 - * @param accessToken 浼佷笟鐨刟ccessToken + /** + * 鑾峰彇浼佷笟瀹㈡埛璇︽儏淇℃伅 + * + * @param accessToken 浼佷笟鐨刟ccessToken * @param externalUserId 澶栭儴浜哄憳鐨剈serId - * @return + * @return 杩斿洖 */ - public static JSONObject getClientData(String accessToken,String externalUserId){ + public static JSONObject getClientData(String accessToken, String externalUserId) { - return HttpURLUtil(GET_CLIENT_DETAIL_URL+"?access_token="+accessToken+"&external_userid="+externalUserId,null); - } + return HttpURLUtil(GET_CLIENT_DETAIL_URL + "?access_token=" + accessToken + "&external_userid=" + externalUserId, null); + } - /** 娣诲姞瀹㈡埛鑱旂郴浜烘爣绛撅紝 - *濡傛灉瑕佸悜鎸囧畾鐨勬爣绛剧粍涓嬫坊鍔犳爣绛撅紝闇�瑕佸~鍐檊roup_id鍙傛暟锛涘鏋滆鍒涘缓涓�涓叏鏂扮殑鏍囩缁勪互鍙婃爣绛撅紝 - *鍒欓渶瑕侀�氳繃group_name鍙傛暟鎸囧畾鏂版爣绛剧粍鍚嶇О锛屽鏋滃~鍐欑殑groupname宸茬粡瀛樺湪锛屽垯浼氬湪姝ゆ爣绛剧粍涓嬫柊寤烘爣绛� + /** + * 浼佷笟鍙�氳繃姝ゆ帴鍙h幏鍙栦紒涓氬鎴锋爣绛捐鎯� + * * @param accessToken 浼佷笟鐨刟ccessToken - * @param groupId 缁刬d锛堢粍鍚嶇О鍜岀粍id蹇呭~涓�涓級 - * @param groupName 缁勫悕绉� 缁勫悕绉板拰缁刬d蹇呭~涓�涓級 - * @param groupOrder 缁勬帓搴忥紝涓嶅~榛樿浼佷笟寰俊鐢熸垚瑙勫垯 - * @param tagArray 鏁扮粍锛屾牸寮忥細[{ "name": "TAG_NAME_1", "order": 1 }] - * @return + * @param tagId 鏍囩id + * @param groupId 鏍囩缁刬d + * @return 杩斿洖 */ - public static JSONObject addTable(String accessToken,String groupId,String groupName,String groupOrder,JSONArray tagArray){ - JSONObject data = new JSONObject(); - data.put("group_id",groupId); - data.put("group_name",groupName); - data.put("order",groupOrder); - data.put("tag",tagArray); - return HttpURLUtil(ADD_TAG+accessToken,data.toString()); - } + public static JSONObject getCorpTagList(String accessToken, JSONArray tagId, JSONArray groupId) { + JSONObject data = new JSONObject(); + data.put("tag_id", tagId); + data.put("group_id", groupId); + return HttpURLUtil(GET_CORP_TAG_LIST + accessToken, data.toString()); + } - /**鍒犻櫎瀹㈡埛鑱旂郴浜烘爣绛� + /** + * 娣诲姞瀹㈡埛鑱旂郴浜烘爣绛撅紝 + * 濡傛灉瑕佸悜鎸囧畾鐨勬爣绛剧粍涓嬫坊鍔犳爣绛撅紝闇�瑕佸~鍐檊roup_id鍙傛暟锛涘鏋滆鍒涘缓涓�涓叏鏂扮殑鏍囩缁勪互鍙婃爣绛撅紝 + * 鍒欓渶瑕侀�氳繃group_name鍙傛暟鎸囧畾鏂版爣绛剧粍鍚嶇О锛屽鏋滃~鍐欑殑groupname宸茬粡瀛樺湪锛屽垯浼氬湪姝ゆ爣绛剧粍涓嬫柊寤烘爣绛� + * + * @param accessToken 浼佷笟鐨刟ccessToken + * @param groupId 缁刬d锛堢粍鍚嶇О鍜岀粍id蹇呭~涓�涓級 + * @param groupName 缁勫悕绉� 缁勫悕绉板拰缁刬d蹇呭~涓�涓級 + * @param groupOrder 缁勬帓搴忥紝涓嶅~榛樿浼佷笟寰俊鐢熸垚瑙勫垯 + * @param tagArray 鏁扮粍锛屾牸寮忥細[{ "name": "TAG_NAME_1", "order": 1 }] + * @return 杩斿洖 + */ + public static JSONObject addTable(String accessToken, String groupId, String groupName, String groupOrder, JSONArray tagArray) { + JSONObject data = new JSONObject(); + data.put("group_id", groupId); + data.put("group_name", groupName); + data.put("order", groupOrder); + data.put("tag", tagArray); + return HttpURLUtil(ADD_TAG + accessToken, data.toString()); + } + + /** + * 缂栬緫浼佷笟瀹㈡埛鏍囩锛� + * 娉ㄦ剰:淇敼鍚庣殑鏍囩缁勪笉鑳藉拰宸叉湁鐨勬爣绛剧粍閲嶅悕锛屾爣绛句篃涓嶈兘鍜屽悓涓�鏍囩缁勪笅鐨勫叾浠栨爣绛鹃噸鍚嶃�� + * + * @param accessToken 浼佷笟鐨刟ccessToken + * @param id 鏍囩鎴栨爣绛剧粍鐨刬d + * @param name 鏂扮殑鏍囩鎴栨爣绛剧粍鍚嶇О锛屾渶闀夸负30涓瓧绗� + * @param order 鏍囩/鏍囩缁勭殑娆″簭鍊笺�俹rder鍊煎ぇ鐨勬帓搴忛潬鍓嶃�傛湁鏁堢殑鍊艰寖鍥存槸[0, 2^32) + * @return 杩斿洖 + */ + public static JSONObject editTable(String accessToken, String id, String name, String order) { + JSONObject data = new JSONObject(); + data.put("id", id); + data.put("name", name); + data.put("order", order); + return HttpURLUtil(EDIT_TAG + accessToken, data.toString()); + } + + /** + * 鍒犻櫎瀹㈡埛鑱旂郴浜烘爣绛� * groupArr鍜宼agArr涓嶅彲鍚屾椂涓虹┖銆� * 濡傛灉涓�涓爣绛剧粍涓嬫墍鏈夌殑鏍囩鍧囪鍒犻櫎锛屽垯鏍囩缁勪細琚嚜鍔ㄥ垹闄ゃ�� + * * @param accessToken 浼佷笟鐨刟ccessToken - * @param groupArr 缁刬d鏁扮粍 - * @param tagArr 鏍囩id鏁扮粍 - * @return + * @param groupArr 缁刬d鏁扮粍 + * @param tagArr 鏍囩id鏁扮粍 + * @return 杩斿洖 */ - public static JSONObject delTable(String accessToken,JSONArray groupArr,String tagArr){ - JSONObject data = new JSONObject(); - data.put("tag_id",tagArr); - data.put("group_id",groupArr); - return HttpURLUtil(DEL_TAG+accessToken,data.toString()); - } + public static JSONObject delTable(String accessToken, JSONArray groupArr, JSONArray tagArr) { + JSONObject data = new JSONObject(); + data.put("tag_id", tagArr); + data.put("group_id", groupArr); + return HttpURLUtil(DEL_TAG + accessToken, data.toString()); + } /** * 瀹㈡埛鍏宠仈浼佷笟寰俊鐨勬爣绛� * 娉ㄦ剰锛氳纭繚external_userid鏄痷serid鐨勫閮ㄨ仈绯讳汉銆� * add_tag鍜宺emove_tag涓嶅彲鍚屾椂涓虹┖銆� - * @param accessToken 浼佷笟鐨刟ccessToken - * @param userId 浼佷笟鎴愬憳鐨剈serid + * + * @param accessToken 浼佷笟鐨刟ccessToken + * @param userId 浼佷笟鎴愬憳鐨剈serid * @param externalUserId 澶栭儴鑱旂郴浜虹殑id - * @param addTag 鏂板鐨勬爣绛緄d锛堜紒涓氭爣绛剧殑id锛夋暟缁� - * @param removeTag 鍒犻櫎鐨勬爣绛緄d锛堜紒涓氭爣绛剧殑id锛夋暟缁� - * @return + * @param addTag 鏂板鐨勬爣绛緄d锛堜紒涓氭爣绛剧殑id锛夋暟缁� + * @param removeTag 鍒犻櫎鐨勬爣绛緄d锛堜紒涓氭爣绛剧殑id锛夋暟缁� + * @return 杩斿洖 */ - public static JSONObject relationTag(String accessToken,String userId,String externalUserId - ,JSONArray addTag,JSONArray removeTag){ + public static JSONObject relationTag(String accessToken, String userId, String externalUserId, JSONArray addTag, JSONArray removeTag) { JSONObject data = new JSONObject(); - data.put("userid",userId); - data.put("external_userid",externalUserId); - data.put("add_tag",addTag); - data.put("remove_tag",removeTag); - return HttpURLUtil(RELATION_TAG+accessToken,data.toString()); + data.put("userid", userId); + data.put("external_userid", externalUserId); + data.put("add_tag", addTag); + data.put("remove_tag", removeTag); + return HttpURLUtil(RELATION_TAG + accessToken, data.toString()); } - /** 璇锋眰http鍗忚 鑾峰彇淇℃伅宸ュ叿 **/ + /** + * 璇锋眰http鍗忚 鑾峰彇淇℃伅宸ュ叿 + **/ public static JSONObject HttpURLUtil(String url, String data) { HttpURLConnection con = null; URL u = null; -- Gitblit v1.8.0