文档更新

docs/admin-openapi.yaml

@@ -8356,6 +8356,12 @@ components:
                     description: 总数
                     type: integer
             type: object
+        DtoWechatAppIDResponse:
+            properties:
+                app_id:
+                    description: 当前生效的公众号 AppID
+                    type: string
+            type: object
         DtoWechatConfigListResponse:
             properties:
                 items:
@@ -25442,6 +25448,51 @@ paths:
             summary: 钱包流水列表
             tags:
                 - 个人客户 - 钱包
+    /api/c/v1/wechat/appid:
+        get:
+            description: 用于 C 端免登录场景获取当前生效微信配置中的公众号 AppID，响应仅返回 app_id 字段
+            responses:
+                "200":
+                    content:
+                        application/json:
+                            schema:
+                                properties:
+                                    code:
+                                        description: 响应码
+                                        example: 0
+                                        type: integer
+                                    data:
+                                        $ref: '#/components/schemas/DtoWechatAppIDResponse'
+                                    msg:
+                                        description: 响应消息
+                                        example: success
+                                        type: string
+                                    timestamp:
+                                        description: 时间戳
+                                        format: date-time
+                                        type: string
+                                required:
+                                    - code
+                                    - msg
+                                    - data
+                                    - timestamp
+                                type: object
+                    description: 成功
+                "400":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 请求参数错误
+                "500":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 服务器内部错误
+            summary: 获取当前生效的公众号 AppID
+            tags:
+                - 个人客户 - 微信
     /api/c/v1/wechat/jssdk-config:
         get:
             description: 前端调用 wx.config() 初始化微信 JS-SDK 时所需的签名参数，需传入当前页面完整 URL

docs/client-wechat-appid/功能总结.md

@@ -0,0 +1,30 @@
+# C 端微信 AppID 获取接口功能总结
+
+## 功能概述
+
+新增 C 端免登录接口 `GET /api/c/v1/wechat/appid`，用于返回当前生效微信配置中的公众号 `AppID`。
+
+## 接口行为
+
+- 无需登录即可访问
+- 统一从当前生效微信配置读取 `oa_app_id`
+- 响应 `data` 中仅返回 `app_id` 字段
+- 当不存在生效配置或公众号 `AppID` 为空时，返回 `微信配置不可用`
+
+## 适用场景
+
+- 前端在发起公众号授权前，先获取当前环境应使用的 `AppID`
+- 前端在初始化微信相关能力时，避免硬编码 `AppID`
+
+## 返回示例
+
+```json
+{
+  "code": 0,
+  "msg": "success",
+  "data": {
+    "app_id": "wx1234567890abcdef"
+  },
+  "timestamp": 1745999999
+}
+```