首頁 GitHub

刪除 API

最後更新

本頁說明 DELETE /del/{path} 如何把檔案或資料夾搬入垃圾桶，以及如何還原。

請求

項目 值
方法 DELETE
路徑 /del/{path}，{path} 為 storage/image/upload/ 下的檔案或資料夾，結尾的 / 會被移除
主體 不需要

搬移規則

規則 行為
目的地 storage/image/upload/.trash/{YYYY-MM-DD}/{最後一段名稱}
日期 UTC 日期（toISOString()）
同名衝突 目的地已存在時追加 _{毫秒時間戳記}，檔案保留副檔名（a_1791311009904.jpg），資料夾直接追加（x_1791311009904）

回應

狀態 型別 內容
200 JSON { "success": 1, "message": "檔案已移動至垃圾桶: {伺服器絕對路徑}" }
200 JSON 資料夾：檔案夾已移動至垃圾桶: {伺服器絕對路徑}
400 文字 未指定檔案/檔案夾
404 文字 檔案/檔案夾不存在
500 文字 系統錯誤訊息

範例

# 刪除單一檔案
curl -fsS -X DELETE \
  http://localhost:8080/del/blog/2025/ERftP1gTS7WCTeJ8_1744080848530.jpg

# 刪除整個資料夾
curl -fsS -X DELETE http://localhost:8080/del/blog/2025

還原

把垃圾桶中的項目移回原路徑即可（Docker Compose 部署時主機路徑為 ./image/）：

mv ./image/upload/.trash/2026-10-06/ERftP1gTS7WCTeJ8_1744080848530.jpg \
   ./image/upload/blog/2025/
EN