1

doc/WPS365集成使用说明.md

@@ -32,7 +32,8 @@ wps365:
   # 应用密钥（从WPS365开放平台获取）
   app-key: YOUR_APP_KEY
   # 授权回调地址（需要在WPS365开放平台配置）
-  redirect-uri: https://your-domain.com/jarvis/wps365/oauth/callback
+  # 注意：使用 /wps365-callback 路径，避免前端路由拦截
+  redirect-uri: https://your-domain.com/wps365-callback
   # API基础地址（一般不需要修改）
   api-base-url: https://open.wps.cn/api/v1
   # OAuth授权地址（一般不需要修改）
@@ -43,6 +44,11 @@ wps365:
   refresh-token-url: https://open.wps.cn/oauth2/v1/token
 ```
 
+**重要提示**：
+- 回调地址使用 `/wps365-callback` 而不是 `/jarvis/wps365/oauth/callback`
+- 这样可以避免前端路由拦截，确保OAuth回调能正常访问
+- 在WPS365开放平台配置时，只需配置域名（如：`jarvis.van333.cn`），回调路径会自动使用配置中的完整URL
+
 ## API接口说明
 
 ### 1. 获取授权URL
@@ -67,13 +73,19 @@ window.open(authUrl, '_blank')
 
 ### 2. OAuth回调处理
 
-**接口**: `GET /jarvis/wps365/oauth/callback`
+**接口**: `GET /wps365-callback`
 
 **参数**:
 - `code`: 授权码（由WPS365回调时自动传入）
 - `state`: 状态参数（可选）
+- `error`: 错误码（授权失败时）
+- `error_description`: 错误描述（授权失败时）
 
-**说明**: 此接口处理WPS365的授权回调，自动获取并保存Token。
+**说明**: 
+- 此接口处理WPS365的授权回调，自动获取并保存Token
+- 返回HTML页面，显示授权结果
+- 使用 `/wps365-callback` 路径避免前端路由拦截
+- 授权成功后会显示成功页面，3秒后自动关闭窗口
 
 ### 3. 获取Token状态