🆕 [微信开放平台]-增加半屏小程序管理相关接口

weixin-java-common/src/main/java/me/chanjar/weixin/common/error/WxMaErrorMsgEnum.java

@@ -711,6 +711,132 @@ public enum WxMaErrorMsgEnum {
   CODE_89255(89255, "code参数无效，请检查code长度以及内容是否正确_；注意code_type的值不同需要传的code长度不一样 ；注意code_type的值不同需要传的code长度不一样"),
 
 //  CODE_504002(-504002, "云函数未找到 Function not found"),
+
+  /**
+   * 半屏小程序系统错误
+   */
+  CODE_89408(89408, "半屏小程序系统错误"),
+
+  /**
+   * 获取半屏小程序列表参数错误
+   */
+  CODE_89409(89409, "获取半屏小程序列表参数错误"),
+
+  /**
+   * 添加半屏小程序appid参数错误
+   */
+  CODE_89410(89410, "添加半屏小程序appid参数错误"),
+
+  /**
+   * 添加半屏小程序appid参数为空
+   */
+  CODE_89411(89411, "添加半屏小程序appid参数为空"),
+
+  /**
+   * 添加半屏小程序申请理由不得超过30个字
+   */
+  CODE_89412(89412, "添加半屏小程序申请理由不得超过30个字"),
+
+  /**
+   * 该小程序被申请次数已达24h限制
+   */
+  CODE_89413(89413, "该小程序被申请次数已达24h限制"),
+
+  /**
+   * 每天仅允许申请50次半屏小程序
+   */
+  CODE_89414(89414, "每天仅允许申请50次半屏小程序"),
+
+  /**
+   * 删除半屏小程序appid参数为空
+   */
+  CODE_89415(89415, "删除半屏小程序appid参数为空"),
+
+  /**
+   * 取消半屏小程序授权appid参数为空
+   */
+  CODE_89416(89416, "取消半屏小程序授权appid参数为空"),
+
+  /**
+   * 修改半屏小程序方式flag参数错误
+   */
+  CODE_89417(89417, "修改半屏小程序方式flag参数错误"),
+
+  /**
+   * 获取半屏小程序每日申请次数失败
+   */
+  CODE_89418(89418, "获取半屏小程序每日申请次数失败"),
+
+  /**
+   * 获取半屏小程序每日授权次数失败
+   */
+  CODE_89419(89419, "获取半屏小程序每日授权次数失败"),
+
+  /**
+   * 不支持添加个人主体小程序
+   */
+  CODE_89420(89420, "不支持添加个人主体小程序"),
+
+  /**
+   * 删除数据未找到
+   */
+  CODE_89421(89421, "删除数据未找到"),
+
+  /**
+   * 删除状态异常
+   */
+  CODE_89422(89422, "删除状态异常"),
+
+  /**
+   * 申请次数添加到达上限
+   */
+  CODE_89423(89423, "申请次数添加到达上限"),
+
+  /**
+   * 申请添加已超时
+   */
+  CODE_89425(89425, "申请添加已超时"),
+
+  /**
+   * 申请添加状态异常
+   */
+  CODE_89426(89426, "申请添加状态异常"),
+
+  /**
+   * 申请号和授权号相同
+   */
+  CODE_89427(89427, "申请号和授权号相同"),
+
+  /**
+   * 该小程序已申请，不允许重复添加
+   */
+  CODE_89428(89428, "该小程序已申请，不允许重复添加"),
+
+  /**
+   * 已到达同一小程序每日最多申请次数
+   */
+  CODE_89429(89429, "已到达同一小程序每日最多申请次数"),
+
+  /**
+   * 该小程序已设置自动拒绝申请
+   */
+  CODE_89430(89430, "该小程序已设置自动拒绝申请"),
+
+  /**
+   * 不支持此类型小程序
+   */
+  CODE_89431(89431, "不支持此类型小程序"),
+
+  /**
+   * 不是小程序
+   */
+  CODE_89432(89432, "不是小程序"),
+
+  /**
+   * 授权次数到达上限
+   */
+  CODE_89424(89424, "授权次数到达上限"),
+
   ;
 
   private final int code;

weixin-java-open/src/main/java/me/chanjar/weixin/open/api/WxOpenMaEmbeddedService.java

@@ -0,0 +1,133 @@
+package me.chanjar.weixin.open.api;
+
+import me.chanjar.weixin.common.error.WxErrorException;
+import me.chanjar.weixin.open.bean.result.WxOpenMaEmbeddedListResult;
+
+/**
+ * 半屏小程序管理服务
+ * <pre>
+ *   <a href="https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/embedded-management/addEmbedded.html">半屏小程序管理</a>
+ * </pre>
+ *
+ * @author Yuan
+ * @version 1.0.0
+ * @date 2024-12-04 16:55:19
+ */
+public interface WxOpenMaEmbeddedService {
+
+  /**
+   * 添加半屏小程序
+   * <pre>
+   *     本接口用于添加半屏小程序
+   * </pre>
+   */
+  String API_ADD_EMBEDDED = "https://api.weixin.qq.com/wxaapi/wxaembedded/add_embedded";
+
+  /**
+   * 删除半屏小程序
+   * <pre>
+   *     用本接口可以删除已经获得授权调用的半屏小程序
+   *     说明：通过add_embedded接口添加半屏小程序后，可通过当前接口删除已经添加到半屏小程序列表的小程序
+   * </pre>
+   */
+  String API_DELETE_EMBEDDED = "https://api.weixin.qq.com/wxaapi/wxaembedded/del_embedded";
+
+  /**
+   * 获取半屏小程序调用列表
+   * <pre>
+   *     调用本接口可以获取半屏小程序调用列表
+   *     说明：通过addEmbedded接口添加半屏小程序后，可通过当前接口获取半屏小程序调用列表
+   * </pre>
+   */
+  String API_GET_EMBEDDED_LIST = "https://api.weixin.qq.com/wxaapi/wxaembedded/get_list";
+
+  /**
+   * 取消授权小程序
+   * <pre>
+   *     调用本接口可以取消已经授权的小程序
+   *     说明：可通过get_own_list接口获取当前半屏小程序已经授权的小程序列表，可通过当前接口取消对某个小程序的调用权限
+   * </pre>
+   */
+  String API_DELETE_AUTHORIZED_EMBEDDED = "https://api.weixin.qq.com/wxaapi/wxaembedded/del_authorize";
+
+  /**
+   * 获取半屏小程序授权列表
+   * <pre>
+   *     调用本接口可以获取半屏小程序授权列表
+   *     说明：一个半屏小程序可授权给1000个小程序调用，通过该接口可获取已经授权的小程序列表
+   * </pre>
+   */
+  String API_GET_OWN_LIST = "https://api.weixin.qq.com/wxaapi/wxaembedded/get_own_list";
+
+  /**
+   * 设置授权方式
+   */
+  String API_SET_AUTHORIZED_EMBEDDED = "https://api.weixin.qq.com/wxaapi/wxaembedded/set_authorize";
+
+  /**
+   * 添加半屏小程序
+   *
+   * @param embeddedAppId 半屏小程序appId
+   * @param applyReason   申请理由
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  void addEmbedded(String embeddedAppId, String applyReason) throws WxErrorException;
+
+  /**
+   * 删除半屏小程序
+   *
+   * @param embeddedAppId 半屏小程序appId
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  void deleteEmbedded(String embeddedAppId) throws WxErrorException;
+
+  /**
+   * 获取半屏小程序调用列表
+   *
+   * @return {@link WxOpenMaEmbeddedListResult }
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  WxOpenMaEmbeddedListResult getEmbeddedList() throws WxErrorException;
+
+  /**
+   * 取消授权小程序
+   *
+   * @param embeddedAppId 半屏小程序appId
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  void deleteAuthorizedEmbedded(String embeddedAppId) throws WxErrorException;
+
+  /**
+   * 获取半屏小程序授权列表,默认分页起始值为0，一次拉取最大值为1000
+   *
+   * @return {@link WxOpenMaEmbeddedListResult }
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  WxOpenMaEmbeddedListResult getOwnList() throws WxErrorException;
+
+  /**
+   * 获取半屏小程序授权列表
+   *
+   * @param start 分页起始值 ，默认值为0
+   * @param num   一次拉取最大值，最大 1000，默认值为10
+   * @return {@link WxOpenMaEmbeddedListResult }
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  WxOpenMaEmbeddedListResult getOwnList(Integer start, Integer num) throws WxErrorException;
+
+  /**
+   * 设置授权方式
+   *
+   * @param flag 半屏小程序授权方式。0表示需要管理员验证；1表示自动通过；2表示自动拒绝。
+   * @author Yuan
+   * @date 2024-12-04 17:33:33
+   */
+  void setAuthorizedEmbedded(Integer flag) throws WxErrorException;
+
+}

weixin-java-open/src/main/java/me/chanjar/weixin/open/api/WxOpenMaService.java

@@ -738,6 +738,15 @@ WxOpenMaDomainResult modifyDomain(String action, List<String> requestDomains, Li
    */
   WxOpenMaPrivacyService getPrivacyService();
 
+  /**
+   * 半屏小程序服务
+   *
+   * @return {@link WxOpenMaEmbeddedService }
+   * @author Yuan
+   * @date 2024-12-04 18:42:21
+   */
+  WxOpenMaEmbeddedService getEmbeddedService();
+
   /**
    * 购物订单
    *