@@ -4,6 +4,7 @@ import me.chanjar.weixin.common.exception.WxErrorException; | |||||
import me.chanjar.weixin.cp.bean.WxCpUser; | import me.chanjar.weixin.cp.bean.WxCpUser; | ||||
import java.util.List; | import java.util.List; | ||||
import java.util.Map; | |||||
/** | /** | ||||
* <pre> | * <pre> | ||||
@@ -90,6 +91,46 @@ public interface WxCpUserService { | |||||
* @param userId 用户的userid | * @param userId 用户的userid | ||||
* @param inviteTips 推送到微信上的提示语(只有认证号可以使用)。当使用微信推送时,该字段默认为“请关注XXX企业号”,邮件邀请时,该字段无效。 | * @param inviteTips 推送到微信上的提示语(只有认证号可以使用)。当使用微信推送时,该字段默认为“请关注XXX企业号”,邮件邀请时,该字段无效。 | ||||
* @return 1:微信邀请 2.邮件邀请 | * @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; | int invite(String userId, String inviteTips) throws WxErrorException; | ||||
/** | |||||
* <pre> | |||||
* userid转openid. | |||||
* 该接口使用场景为微信支付、微信红包和企业转账。 | |||||
* | |||||
* 在使用微信支付的功能时,需要自行将企业微信的userid转成openid。 | |||||
* 在使用微信红包功能时,需要将应用id和userid转成appid和openid才能使用。 | |||||
* 注:需要成员使用微信登录企业微信或者关注微信插件才能转成openid | |||||
* | |||||
* 文档地址:https://work.weixin.qq.com/api/doc#11279 | |||||
* </pre> | |||||
* | |||||
* @param userId 企业内的成员id | |||||
* @param agentId 非必填,整型,仅用于发红包。其它场景该参数不要填,如微信支付、企业转账、电子发票 | |||||
* @return map对象,可能包含以下值: | |||||
* - openid 企业微信成员userid对应的openid,若有传参agentid,则是针对该agentid的openid。否则是针对企业微信corpid的openid | |||||
* - appid 应用的appid,若请求包中不包含agentid则不返回appid。该appid在使用微信红包时会用到 | |||||
*/ | |||||
Map<String, String> userId2Openid(String userId, Integer agentId) throws WxErrorException; | |||||
/** | |||||
* <pre> | |||||
* openid转userid | |||||
* | |||||
* 该接口主要应用于使用微信支付、微信红包和企业转账之后的结果查询。 | |||||
* 开发者需要知道某个结果事件的openid对应企业微信内成员的信息时,可以通过调用该接口进行转换查询。 | |||||
* 权限说明: | |||||
* 管理组需对openid对应的企业微信成员有查看权限。 | |||||
* | |||||
* 文档地址:https://work.weixin.qq.com/api/doc#11279 | |||||
* </pre> | |||||
* | |||||
* @param openid 在使用微信支付、微信红包和企业转账之后,返回结果的openid | |||||
* @return userid 该openid在企业微信对应的成员userid | |||||
*/ | |||||
String openid2UserId(String openid) throws WxErrorException; | |||||
} | } |
@@ -1,5 +1,6 @@ | |||||
package me.chanjar.weixin.cp.api.impl; | package me.chanjar.weixin.cp.api.impl; | ||||
import com.google.common.collect.Maps; | |||||
import com.google.gson.*; | import com.google.gson.*; | ||||
import com.google.gson.reflect.TypeToken; | import com.google.gson.reflect.TypeToken; | ||||
import me.chanjar.weixin.common.exception.WxErrorException; | 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 org.apache.commons.lang3.StringUtils; | ||||
import java.util.List; | import java.util.List; | ||||
import java.util.Map; | |||||
/** | /** | ||||
* <pre> | * <pre> | ||||
@@ -114,6 +116,7 @@ public class WxCpUserServiceImpl implements WxCpUserService { | |||||
} | } | ||||
@Override | @Override | ||||
@Deprecated | |||||
public int invite(String userId, String inviteTips) throws WxErrorException { | public int invite(String userId, String inviteTips) throws WxErrorException { | ||||
String url = "https://qyapi.weixin.qq.com/cgi-bin/invite/send"; | String url = "https://qyapi.weixin.qq.com/cgi-bin/invite/send"; | ||||
JsonObject jsonObject = new JsonObject(); | JsonObject jsonObject = new JsonObject(); | ||||
@@ -125,4 +128,37 @@ public class WxCpUserServiceImpl implements WxCpUserService { | |||||
JsonElement tmpJsonElement = new JsonParser().parse(responseContent); | JsonElement tmpJsonElement = new JsonParser().parse(responseContent); | ||||
return tmpJsonElement.getAsJsonObject().get("type").getAsInt(); | return tmpJsonElement.getAsJsonObject().get("type").getAsInt(); | ||||
} | } | ||||
@Override | |||||
public Map<String, String> userId2Openid(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<String, String> 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(); | |||||
} | |||||
} | } |
@@ -6,11 +6,14 @@ import me.chanjar.weixin.cp.api.WxCpService; | |||||
import me.chanjar.weixin.cp.bean.WxCpUser; | import me.chanjar.weixin.cp.bean.WxCpUser; | ||||
import org.apache.commons.lang3.builder.ToStringBuilder; | import org.apache.commons.lang3.builder.ToStringBuilder; | ||||
import org.apache.commons.lang3.builder.ToStringStyle; | 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.List; | ||||
import java.util.Map; | |||||
import static org.testng.Assert.*; | |||||
import static org.testng.Assert.assertNotEquals; | |||||
import static org.testng.Assert.assertNotNull; | |||||
/** | /** | ||||
* <pre> | * <pre> | ||||
@@ -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 { | |||||
Map<String, String> result = 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); | |||||
} | |||||
} | } |