diff --git a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpUserService.java b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpUserService.java index 1487d861..93333fef 100644 --- a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpUserService.java +++ b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpUserService.java @@ -4,6 +4,7 @@ import me.chanjar.weixin.common.exception.WxErrorException; import me.chanjar.weixin.cp.bean.WxCpUser; import java.util.List; +import java.util.Map; /** *
@@ -90,6 +91,46 @@ public interface WxCpUserService { * @param userId 用户的userid * @param inviteTips 推送到微信上的提示语(只有认证号可以使用)。当使用微信推送时,该字段默认为“请关注XXX企业号”,邮件邀请时,该字段无效。 * @return 1:微信邀请 2.邮件邀请 + * @deprecated api obsoleted. 邀请关注的功能微信企业号已经下线了, + * 详细请参考该链接点击查看 https://qy.weixin.qq.com/cgi-bin/homepagenotify?action=get&id=46 */ + @Deprecated int invite(String userId, String inviteTips) throws WxErrorException; + + /** + *+ * userid转openid. + * 该接口使用场景为微信支付、微信红包和企业转账。 + * + * 在使用微信支付的功能时,需要自行将企业微信的userid转成openid。 + * 在使用微信红包功能时,需要将应用id和userid转成appid和openid才能使用。 + * 注:需要成员使用微信登录企业微信或者关注微信插件才能转成openid + * + * 文档地址:https://work.weixin.qq.com/api/doc#11279 + *+ * + * @param userId 企业内的成员id + * @param agentId 非必填,整型,仅用于发红包。其它场景该参数不要填,如微信支付、企业转账、电子发票 + * @return map对象,可能包含以下值: + * - openid 企业微信成员userid对应的openid,若有传参agentid,则是针对该agentid的openid。否则是针对企业微信corpid的openid + * - appid 应用的appid,若请求包中不包含agentid则不返回appid。该appid在使用微信红包时会用到 + */ + MapuserId2Openid(String userId, Integer agentId) throws WxErrorException; + + /** + * + * openid转userid + * + * 该接口主要应用于使用微信支付、微信红包和企业转账之后的结果查询。 + * 开发者需要知道某个结果事件的openid对应企业微信内成员的信息时,可以通过调用该接口进行转换查询。 + * 权限说明: + * 管理组需对openid对应的企业微信成员有查看权限。 + * + * 文档地址:https://work.weixin.qq.com/api/doc#11279 + *+ * + * @param openid 在使用微信支付、微信红包和企业转账之后,返回结果的openid + * @return userid 该openid在企业微信对应的成员userid + */ + String openid2UserId(String openid) throws WxErrorException; } diff --git a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImpl.java b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImpl.java index dbb5a2f3..f0249e8e 100644 --- a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImpl.java +++ b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImpl.java @@ -1,5 +1,6 @@ package me.chanjar.weixin.cp.api.impl; +import com.google.common.collect.Maps; import com.google.gson.*; import com.google.gson.reflect.TypeToken; import me.chanjar.weixin.common.exception.WxErrorException; @@ -10,6 +11,7 @@ import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder; import org.apache.commons.lang3.StringUtils; import java.util.List; +import java.util.Map; /** *@@ -114,6 +116,7 @@ public class WxCpUserServiceImpl implements WxCpUserService { } @Override + @Deprecated public int invite(String userId, String inviteTips) throws WxErrorException { String url = "https://qyapi.weixin.qq.com/cgi-bin/invite/send"; JsonObject jsonObject = new JsonObject(); @@ -125,4 +128,37 @@ public class WxCpUserServiceImpl implements WxCpUserService { JsonElement tmpJsonElement = new JsonParser().parse(responseContent); return tmpJsonElement.getAsJsonObject().get("type").getAsInt(); } + + @Override + public MapuserId2Openid(String userId, Integer agentId) throws WxErrorException { + String url = "https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_openid"; + JsonObject jsonObject = new JsonObject(); + jsonObject.addProperty("userid", userId); + if (agentId != null) { + jsonObject.addProperty("agentid", agentId); + } + + String responseContent = this.mainService.post(url, jsonObject.toString()); + JsonElement tmpJsonElement = new JsonParser().parse(responseContent); + Map result = Maps.newHashMap(); + if (tmpJsonElement.getAsJsonObject().get("openid") != null) { + result.put("openid", tmpJsonElement.getAsJsonObject().get("openid").getAsString()); + } + + if (tmpJsonElement.getAsJsonObject().get("appid") != null) { + result.put("appid", tmpJsonElement.getAsJsonObject().get("appid").getAsString()); + } + + return result; + } + + @Override + public String openid2UserId(String openid) throws WxErrorException { + String url = "https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_userid"; + JsonObject jsonObject = new JsonObject(); + jsonObject.addProperty("openid", openid); + String responseContent = this.mainService.post(url, jsonObject.toString()); + JsonElement tmpJsonElement = new JsonParser().parse(responseContent); + return tmpJsonElement.getAsJsonObject().get("userid").getAsString(); + } } diff --git a/weixin-java-cp/src/test/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImplTest.java b/weixin-java-cp/src/test/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImplTest.java index 3a7d3deb..bbb5dcab 100644 --- a/weixin-java-cp/src/test/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImplTest.java +++ b/weixin-java-cp/src/test/java/me/chanjar/weixin/cp/api/impl/WxCpUserServiceImplTest.java @@ -6,11 +6,14 @@ import me.chanjar.weixin.cp.api.WxCpService; import me.chanjar.weixin.cp.bean.WxCpUser; import org.apache.commons.lang3.builder.ToStringBuilder; import org.apache.commons.lang3.builder.ToStringStyle; -import org.testng.annotations.*; +import org.testng.annotations.Guice; +import org.testng.annotations.Test; import java.util.List; +import java.util.Map; -import static org.testng.Assert.*; +import static org.testng.Assert.assertNotEquals; +import static org.testng.Assert.assertNotNull; /** * @@ -83,4 +86,24 @@ public class WxCpUserServiceImplTest { } } + @Test + @Deprecated + public void testInvite() throws Exception { + int result = this.wxCpService.getUserService().invite(userId, ""); + System.out.println(result); + } + + @Test + public void testUserId2Openid() throws Exception { + Mapresult = this.wxCpService.getUserService().userId2Openid(userId, null); + System.out.println(result); + assertNotNull(result); + } + + @Test + public void testOpenid2UserId() throws Exception { + String result = this.wxCpService.getUserService().openid2UserId(userId); + System.out.println(result); + assertNotNull(result); + } }