📝 添加微信开放平台小程序审核额度管理指南

2026-02-14 00:08:29 +08:00 · 2025-12-21 21:54:43 +08:00
parent e3463a0adf
commit 40428bc7cf
6 changed files with 616 additions and 5 deletions
--- a/weixin-java-open/src/test/java/me/chanjar/weixin/open/api/impl/WxOpenMaServiceImplTest.java
+++ b/weixin-java-open/src/test/java/me/chanjar/weixin/open/api/impl/WxOpenMaServiceImplTest.java
@@ -306,6 +306,141 @@ public class WxOpenMaServiceImplTest {

  @Test
  public void testQueryQuota() {
+    // 此测试方法演示如何使用审核额度查询功能
+    // 注意：实际运行需要真实的微信 API 凭据
+    /*
+    try {
+      // 查询当前审核额度
+      WxOpenMaQueryQuotaResult quota = wxOpenMaService.queryQuota();
+
+      System.out.println("审核额度信息：");
+      System.out.println("  当月剩余提交审核次数: " + quota.getRest());
+      System.out.println("  当月提交审核额度上限: " + quota.getLimit());
+      System.out.println("  剩余加急次数: " + quota.getSpeedupRest());
+      System.out.println("  加急额度上限: " + quota.getSpeedupLimit());
+
+      // 检查额度是否充足
+      if (quota.getRest() <= 0) {
+        System.err.println("警告：审核额度已用尽！");
+      } else if (quota.getRest() <= 5) {
+        System.out.println("提示：审核额度即将用尽，请注意！");
+      }
+    } catch (WxErrorException e) {
+      e.printStackTrace();
+    }
+    */
+  }
+
+  /**
+   * 演示提交审核前检查额度的最佳实践
+   * <p>
+   * 这是一个完整的示例，展示如何在提交审核前检查额度，避免额度不足导致的失败
+   * </p>
+   */
+  @Test
+  public void testSubmitAuditWithQuotaCheck() {
+    // 此测试方法演示提交审核前的额度检查最佳实践
+    // 注意：实际运行需要真实的微信 API 凭据
+    /*
+    try {
+      // 步骤1：检查审核额度
+      WxOpenMaQueryQuotaResult quota = wxOpenMaService.queryQuota();
+      System.out.println("当前剩余审核额度: " + quota.getRest());
+
+      if (quota.getRest() <= 0) {
+        throw new RuntimeException("审核额度不足，无法提交审核。剩余额度: " + quota.getRest());
+      }
+
+      // 步骤2：准备审核数据
+      WxMaCodeSubmitAuditItem item = new WxMaCodeSubmitAuditItem();
+      item.setAddress("index");
+      item.setTag("工具");
+      item.setFirstClass("工具");
+      item.setSecondClass("效率");
+      item.setTitle("首页");
+
+      WxOpenMaSubmitAuditMessage message = new WxOpenMaSubmitAuditMessage();
+      message.setItemList(Collections.singletonList(item));
+      message.setVersionDesc("修复若干已知问题，优化用户体验");
+
+      // 步骤3：提交审核
+      WxOpenMaSubmitAuditResult result = wxOpenMaService.submitAudit(message);
+      System.out.println("提交审核成功，审核ID: " + result.getAuditId());
+
+      // 步骤4：再次查询额度，确认已消耗
+      quota = wxOpenMaService.queryQuota();
+      System.out.println("提交后剩余审核额度: " + quota.getRest());
+
+    } catch (WxErrorException e) {
+      System.err.println("提交审核失败: " + e.getMessage());
+      e.printStackTrace();
+    }
+    */
+  }
+
+  /**
+   * 演示批量提交审核时的额度管理策略
+   * <p>
+   * 当需要为多个小程序提交审核时，应该先统一检查额度是否充足
+   * </p>
+   */
+  @Test
+  public void testBatchSubmitAuditWithQuotaManagement() {
+    // 此测试方法演示批量提交审核时的额度管理策略
+    // 注意：实际运行需要真实的微信 API 凭据，以及 WxOpenComponentService 实例
+    /*
+    // 假设已经初始化了 wxOpenComponentService
+    // WxOpenComponentService wxOpenComponentService = ...;
+
+    try {
+      // 假设需要为多个小程序提交审核
+      List<String> appIds = Arrays.asList("appid1", "appid2", "appid3");
+
+      // 步骤1：通过任意一个小程序服务查询总体额度
+      // 注意：审核额度是第三方平台级别的，所有授权小程序共享
+      WxOpenMaService firstMaService = wxOpenComponentService.getWxMaServiceByAppid(appIds.get(0));
+      WxOpenMaQueryQuotaResult quota = firstMaService.queryQuota();
+      System.out.println("当前剩余审核额度: " + quota.getRest());
+
+      if (quota.getRest() < appIds.size()) {
+        System.err.println("警告：审核额度不足！");
+        System.err.println("  需要提交: " + appIds.size() + " 个");
+        System.err.println("  剩余额度: " + quota.getRest());
+        System.err.println("  缺少额度: " + (appIds.size() - quota.getRest()));
+        return;
+      }
+
+      // 步骤2：依次提交审核
+      int successCount = 0;
+      for (String appId : appIds) {
+        try {
+          WxOpenMaService maService = wxOpenComponentService.getWxMaServiceByAppid(appId);
+
+          WxOpenMaSubmitAuditMessage message = new WxOpenMaSubmitAuditMessage();
+          // ... 设置审核信息
+
+          WxOpenMaSubmitAuditResult result = maService.submitAudit(message);
+          System.out.println("AppId: " + appId + " 提交成功，审核ID: " + result.getAuditId());
+          successCount++;
+
+        } catch (WxErrorException e) {
+          System.err.println("AppId: " + appId + " 提交失败: " + e.getMessage());
+        }
+      }
+
+      // 步骤3：输出统计信息
+      System.out.println("批量提交完成：");
+      System.out.println("  成功: " + successCount);
+      System.out.println("  失败: " + (appIds.size() - successCount));
+
+      // 步骤4：查询剩余额度
+      quota = firstMaService.queryQuota();
+      System.out.println("  剩余额度: " + quota.getRest());
+
+    } catch (Exception e) {
+      e.printStackTrace();
+    }
+    */
  }

  @Test