1

ruoyi-admin/src/main/resources/application-dev.yml

@@ -187,20 +187,24 @@ xss:
   urlPatterns: /system/*,/monitor/*,/tool/*
 
 # 腾讯文档开放平台配置
+# 文档地址：https://docs.qq.com/open/document/app/openapi/v3/sheet/model/spreadsheet.html
 tencent:
   doc:
-    # 应用ID（需要在腾讯文档开放平台申请）
+    # 应用ID（需要在腾讯文档开放平台申请：https://docs.qq.com/open）
     app-id: 90aa0b70e7704c2abd2a42695d5144a4
-    # 应用密钥（需要在腾讯文档开放平台申请）
+    # 应用密钥（需要在腾讯文档开放平台申请，注意保密）
     app-secret: G8ZdSWcoViIawygo7JSolE86PL32UO0O
-    # 授权回调地址（需要在腾讯文档开放平台配置域名：jarvis.van333.cn，这里使用完整URL）
+    # 授权回调地址（需要在腾讯文档开放平台配置授权域名：jarvis.van333.cn）
+    # 注意：腾讯文档平台只需配置域名，不能包含路径，但这里需要填写完整的回调URL
     redirect-uri: https://jarvis.van333.cn/tendoc-callback
-    # API基础地址（使用V3版本，推荐）
-    api-base-url: https://docs.qq.com/open/v3
-    # OAuth授权地址
+    # API基础地址（V3版本 - 2023年推荐使用，V2版本已废弃）
+    # 完整API文档：https://docs.qq.com/open/document/app/openapi/v3/
+    # 注意：正确的URL是 /openapi/v3 而不是 /open/v3
+    api-base-url: https://docs.qq.com/openapi/v3
+    # OAuth授权地址（用于生成授权链接，引导用户授权）
     oauth-url: https://docs.qq.com/oauth/v2/authorize
-    # 获取Token地址
+    # 获取Token地址（用于通过授权码换取access_token）
     token-url: https://docs.qq.com/oauth/v2/token
-    # 刷新Token地址
+    # 刷新Token地址（用于通过refresh_token刷新access_token）
     refresh-token-url: https://docs.qq.com/oauth/v2/token
 

ruoyi-admin/src/main/resources/application-prod.yml

@@ -186,19 +186,23 @@ xss:
   # 匹配链接
   urlPatterns: /system/*,/monitor/*,/tool/*
 # 腾讯文档开放平台配置
+# 文档地址：https://docs.qq.com/open/document/app/openapi/v3/sheet/model/spreadsheet.html
 tencent:
   doc:
-    # 应用ID（需要在腾讯文档开放平台申请）
+    # 应用ID（需要在腾讯文档开放平台申请：https://docs.qq.com/open）
     app-id: 90aa0b70e7704c2abd2a42695d5144a4
-    # 应用密钥（需要在腾讯文档开放平台申请）
+    # 应用密钥（需要在腾讯文档开放平台申请，注意保密）
     app-secret: G8ZdSWcoViIawygo7JSolE86PL32UO0O
-    # 授权回调地址（需要在腾讯文档开放平台配置域名：jarvis.van333.cn，这里使用完整URL）
+    # 授权回调地址（需要在腾讯文档开放平台配置授权域名：jarvis.van333.cn）
+    # 注意：腾讯文档平台只需配置域名，不能包含路径，但这里需要填写完整的回调URL
     redirect-uri: https://jarvis.van333.cn/tendoc-callback
-    # API基础地址（使用V3版本，推荐）
-    api-base-url: https://docs.qq.com/open/v3
-    # OAuth授权地址
+    # API基础地址（V3版本 - 2023年推荐使用，V2版本已废弃）
+    # 完整API文档：https://docs.qq.com/open/document/app/openapi/v3/
+    # 注意：正确的URL是 /openapi/v3 而不是 /open/v3
+    api-base-url: https://docs.qq.com/openapi/v3
+    # OAuth授权地址（用于生成授权链接，引导用户授权）
     oauth-url: https://docs.qq.com/oauth/v2/authorize
-    # 获取Token地址
+    # 获取Token地址（用于通过授权码换取access_token）
     token-url: https://docs.qq.com/oauth/v2/token
-    # 刷新Token地址
+    # 刷新Token地址（用于通过refresh_token刷新access_token）
     refresh-token-url: https://docs.qq.com/oauth/v2/token