添加获取应用管理员列表接口

Co-authored-by: binarywang <[email protected]>

Author: Copilot

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpAgentService.java

@@ -2,6 +2,7 @@
 
 import me.chanjar.weixin.common.error.WxErrorException;
 import me.chanjar.weixin.cp.bean.WxCpAgent;
+import me.chanjar.weixin.cp.bean.WxCpTpAdmin;
 
 import java.util.List;
 
@@ -52,4 +53,18 @@ public interface WxCpAgentService {
    */
   List<WxCpAgent> list() throws WxErrorException;
 
+  /**
+   * <pre>
+   * 获取应用管理员列表
+   * 第三方服务商可以用此接口获取授权企业中某个第三方应用或者代开发应用的管理员列表(不包括外部管理员)，
+   * 以便服务商在用户进入应用主页之后根据是否管理员身份做权限的区分。
+   * 详情请见: <a href="https://developer.work.weixin.qq.com/document/path/90506">文档</a>
+   * </pre>
+   *
+   * @param agentId 应用id
+   * @return admin list
+   * @throws WxErrorException the wx error exception
+   */
+  WxCpTpAdmin getAdminList(Integer agentId) throws WxErrorException;
+
 }

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpAgentServiceImpl.java

@@ -11,6 +11,7 @@
 import me.chanjar.weixin.cp.api.WxCpAgentService;
 import me.chanjar.weixin.cp.api.WxCpService;
 import me.chanjar.weixin.cp.bean.WxCpAgent;
+import me.chanjar.weixin.cp.bean.WxCpTpAdmin;
 import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder;
 
 import java.util.List;
@@ -65,4 +66,17 @@ public List<WxCpAgent> list() throws WxErrorException {
     }.getType());
   }
 
+  @Override
+  public WxCpTpAdmin getAdminList(Integer agentId) throws WxErrorException {
+    if (agentId == null) {
+      throw new IllegalArgumentException("缺少agentid参数");
+    }
+
+    JsonObject jsonObject = new JsonObject();
+    jsonObject.addProperty("agentid", agentId);
+    String url = this.mainService.getWxCpConfigStorage().getApiUrl(AGENT_GET_ADMIN_LIST);
+    String responseContent = this.mainService.post(url, jsonObject.toString());
+    return WxCpTpAdmin.fromJson(responseContent);
+  }
+
 }

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/constant/WxCpApiPathConsts.java

@@ -112,6 +112,10 @@ interface Agent {
      * The constant AGENT_LIST.
      */
     String AGENT_LIST = "/cgi-bin/agent/list";
+    /**
+     * The constant AGENT_GET_ADMIN_LIST.
+     */
+    String AGENT_GET_ADMIN_LIST = "/cgi-bin/agent/get_admin_list";
   }
 
   /**

weixin-java-cp/src/test/java/me/chanjar/weixin/cp/api/impl/WxCpAgentServiceImplTest.java

@@ -82,6 +82,20 @@ public void testList() throws WxErrorException {
     assertThat(list.get(0).getSquareLogoUrl()).isNotEmpty();
   }
 
+  /**
+   * Test get admin list.
+   *
+   * @throws WxErrorException the wx error exception
+   */
+  @Test
+  public void testGetAdminList() throws WxErrorException {
+    final Integer agentId = this.wxCpService.getWxCpConfigStorage().getAgentId();
+    me.chanjar.weixin.cp.bean.WxCpTpAdmin adminList = this.wxCpService.getAgentService().getAdminList(agentId);
+
+    assertThat(adminList).isNotNull();
+    assertThat(adminList.getErrCode()).isEqualTo(0);
+  }
+
   /**
    * The type Mock test.
    */
@@ -118,6 +132,31 @@ public void testGet() throws Exception {
 
     }
 
+    /**
+     * Test get admin list.
+     *
+     * @throws Exception the exception
+     */
+    @Test
+    public void testGetAdminList() throws Exception {
+      String returnJson = "{\"errcode\": 0,\"errmsg\": \"ok\",\"admin\": [{\"userid\": \"zhangsan\"," +
+        "\"open_userid\": \"woAJ2GCAAAXtWyujaWJHDDGi0mACH71w\",\"auth_type\": 1}," +
+        "{\"userid\": \"lisi\",\"open_userid\": \"woAJ2GCAAAXtWyujaWJHDDGi0mACH72w\",\"auth_type\": 2}]}";
+      final WxCpConfigStorage configStorage = new WxCpDefaultConfigImpl();
+      when(wxService.getWxCpConfigStorage()).thenReturn(configStorage);
+      when(wxService.post(configStorage.getApiUrl(WxCpApiPathConsts.Agent.AGENT_GET_ADMIN_LIST), "{\"agentid\":9}")).thenReturn(returnJson);
+      when(wxService.getAgentService()).thenReturn(new WxCpAgentServiceImpl(wxService));
+
+      WxCpAgentService wxAgentService = this.wxService.getAgentService();
+      me.chanjar.weixin.cp.bean.WxCpTpAdmin adminList = wxAgentService.getAdminList(9);
+
+      assertEquals(0, adminList.getErrCode().intValue());
+      assertEquals(2, adminList.getAdmin().size());
+      assertEquals("zhangsan", adminList.getAdmin().get(0).getUserId());
+      assertEquals("woAJ2GCAAAXtWyujaWJHDDGi0mACH71w", adminList.getAdmin().get(0).getOpenUserId());
+      assertEquals(1, adminList.getAdmin().get(0).getAuthType().intValue());
+    }
+
   }
 
 }