[BUG] API doc中 Upload file的参数错误及缺漏

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

请确认以下事项

• 我已确认阅读并同意 AGPL-3.0 第15条 。
  本程序不提供任何明示或暗示的担保，使用风险由您自行承担。

• 我已确认阅读并同意 AGPL-3.0 第16条 。
  无论何种情况，版权持有人或其他分发者均不对使用本程序所造成的任何损失承担责任。

• 我确认我的描述清晰，语法礼貌，能帮助开发者快速定位问题，并符合社区规则。

• 我已确认阅读了OpenList文档。

• 我已确认没有重复的问题或讨论。

• 我已确认是OpenList的问题，而不是其他原因（例如 网络 ，依赖或操作）。

• 我认为此问题必须由OpenList处理，而非第三方。

• 我已确认这个问题在最新版本中没有被修复。

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文档提供的参数：

实际使用的参数：

配置文件内容（必填）

略

日志（可选）

略

复现链接（可选）

略

Preparare l'ambiente

Come iniziare

1. Leggi tutta la issue e poi la guida ai contributi del progetto.
2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
3. Fai un fork del repository e lavora su un branch.
4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di OpenListTeam/OpenList-Docs

• `Onedrive / 分享` 文档中的 `手动创建应用挂载` 部分似乎已经过时

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla

  Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

  OpenListTeam/OpenList-Docs#381 · Aperta il 3/10/2026

• 「Bug」阿里网盘指定文件夹无法使用

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  invalid

  Difficoltà 3/5 1-2 giorni Idoneità per principianti 45/100

  OpenListTeam/OpenList-Docs#329 · Aperta il 23/4/2026

• [BUG] API and documentation are inconsistent: Created Time (created_at) is not returned by the current share API.

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  API bug

  Difficoltà 3/5 1-2 giorni Idoneità per principianti 48/100

  OpenListTeam/OpenList-Docs#325 · 4 commenti · Aperta il 4/4/2026

• [BUG] 分享文件API文档有误

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  API bug

  Difficoltà 1/5 Meno di un'ora Idoneità per principianti 55/100

  OpenListTeam/OpenList-Docs#306 · 2 commenti · Aperta il 13/2/2026

• [Feature] IPFS支持

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  API enhancement

  Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100

  OpenListTeam/OpenList-Docs#300 · 2 commenti · Aperta il 2/2/2026

Tutte le issue di OpenListTeam/OpenList-Docs