From e5f2bba248b29d06c723bdd8c887b0c103463caa Mon Sep 17 00:00:00 2001
From: Accusys <accusys@Accusyss-MacBook-Pro.local>
Date: Fri, 15 May 2026 03:08:56 +0800
Subject: [PATCH] fix: add /api/v1/register alias for backward compatibility

---
 .../2026-05-14_register_api_404_response.md   | 31 +++++++++++++++++++
 src/api/server.rs                             |  1 +
 2 files changed, 32 insertions(+)
 create mode 100644 docs_v1.0/M4_workspace/2026-05-14_register_api_404_response.md

diff --git a/docs_v1.0/M4_workspace/2026-05-14_register_api_404_response.md b/docs_v1.0/M4_workspace/2026-05-14_register_api_404_response.md
new file mode 100644
index 0000000..0adbd51
--- /dev/null
+++ b/docs_v1.0/M4_workspace/2026-05-14_register_api_404_response.md
@@ -0,0 +1,31 @@
+# Register API 404 — 回覆
+
+**Date**: 2026-05-14
+**From**: M5
+**To**: M4
+**Ref**: `2026-05-14_register_api_404.md`
+
+---
+
+## 根因
+
+正式端點為 `POST /api/v1/files/register`，不是 `POST /api/v1/register`。舊版路由已在某次重構中移除。
+
+已修復：在 build `53d6467` 中新增別名路由，現在兩者皆可用：
+
+| 端點 | 狀態 |
+|------|------|
+| `POST /api/v1/files/register` | ✅ 原始端點 |
+| `POST /api/v1/register` | ✅ 新增別名（回呼相容） |
+
+## Request 格式
+
+```bash
+curl -X POST http://localhost:3002/api/v1/register \
+  -H "X-API-Key: ..." \
+  -H "Content-Type: application/json" \
+  -d '{
+    "file_path": "/path/to/file.svg",
+    "content_hash": "optional-sha256-hex"
+  }'
+```
diff --git a/src/api/server.rs b/src/api/server.rs
index ab27640..d5849ab 100644
--- a/src/api/server.rs
+++ b/src/api/server.rs
@@ -2804,6 +2804,7 @@ pub async fn start_server(host: &str, port: u16) -> anyhow::Result<()> {
 
     let protected_routes = Router::new()
         .route("/api/v1/files/register", post(register_file))
+        .route("/api/v1/register", post(register_file))
         .route("/api/v1/files/lookup", get(lookup_file_by_name))
         .route("/api/v1/unregister", post(unregister))
         .route("/api/v1/files/scan", get(scan_files))