### 请确认以下事项 - [x] 我已确认阅读并同意 [AGPL-3.0 第15条](https://www.gnu.org/licenses/agpl-3.0.txt#:~:text=15.%20Disclaimer%20of%20Warranty.) 。 本程序不提供任何明示或暗示的担保,使用风险由您自行承担。 - [x] 我已确认阅读并同意 [AGPL-3.0 第16条](https://www.gnu.org/licenses/agpl-3.0.txt#:~:text=16.%20Limitation%20of%20Liability.) 。 无论何种情况,版权持有人或其他分发者均不对使用本程序所造成的任何损失承担责任。 - [x] 我确认我的描述清晰,语法礼貌,能帮助开发者快速定位问题,并符合社区规则。 - [x] 我已确认阅读了[OpenList文档](https://doc.oplist.org)。 - [x] 我已确认没有重复的问题或讨论。 - [x] 我已确认是`OpenList`的问题,而不是其他原因(例如 [网络](https://doc.oplist.org/faq/howto#tls-handshake-timeout-read-connection-reset-by-peer-dns-lookup-failed-connect-connection-refused-client-timeout-exceeded-while-awaiting-headers-no-such-host-1) ,`依赖`或`操作`)。 - [x] 我认为此问题必须由`OpenList`处理,而非第三方。 - [x] 我已确认这个问题在最新版本中没有被修复。 ### OpenList 版本(必填) v4.1.6 (Commit: 08574785) - Frontend: v4.1.6 - Build at: 2025-11-03 03:31:13 +0000 ### 使用的存储驱动(必填) Local ### 问题描述(必填) 目前官方的API doc(fox.oplist.org及fox.oplist.org.cn)中关于上传文件的两个api(Upload file (stream)及Upload file (form))中的path参数是不正确的,这会导致根据此文档进行api操作的用户得到错误反馈。并且文档中缺少了"覆盖现有文件"的header值。 文档中提供的上传路径为header->path, 实际为header->File-Path, 且缺少的是"覆盖现有文件"的header->Overwrite, 下面附上截图: API文档提供的参数: <img width="1186" height="771" alt="Image" src="https://github.com/user-attachments/assets/a5113429-6f6c-4d33-8591-9c361c7a49eb" /> <img width="687" height="744" alt="Image" src="https://github.com/user-attachments/assets/a9f5e591-8f58-4157-b531-6144858cde4d" /> 实际使用的参数: <img width="765" height="271" alt="Image" src="https://github.com/user-attachments/assets/4d380f64-d852-4dc1-8b1c-f13f5d95ec29" /> ### 配置文件内容(必填) 略 ### 日志(可选) 略 ### 复现链接(可选) 略
Activity
github-actions commentedon Nov 9, 2025
感谢您联系OpenList。我们会尽快回复您。
Thanks for contacting OpenList. We will reply to you as soon as possible.