feat: Add admin ebook folder management routes to Bruno collection

- Add POST /api/auth/ebook-folders for adding ebook folders - Add GET /api/auth/ebook-folders for retrieving configured folders - Add DELETE /api/auth/ebook-folders for removing ebook folders - Include comprehensive documentation and request examples - Support path normalization and admin-only access
2026-01-27 16:23:42 -05:00
parent 7116af9a77
commit 4a71376ed5
3 changed files with 156 additions and 0 deletions
@@ -0,0 +1,56 @@
+meta {
+  name: Add Ebook Folder
+  type: http
+  seq: 8
+}
+
+post {
+  url: {{base_url}}/api/auth/ebook-folders
+  body: json
+  auth: inherit
+}
+
+body:json {
+  {
+    "folder_path": "/path/to/ebooks"
+  }
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}
+
+docs {
+  ## Add Ebook Folder
+  
+  Adds a new ebook folder for the authenticated user.
+  
+  **Method:** POST
+  
+  **Endpoint:** /api/auth/ebook-folders
+  
+  **Authentication:** Required (Admin only)
+  
+  **Request Body:** JSON object with:
+  - `folder_path` (string, required): Path to the ebook folder
+  
+  **Response:** Folder object with:
+  - `id` (string): Folder ID (UUID)
+  - `user_id` (string): User ID (UUID)
+  - `folder_path` (string): Normalized folder path
+  - `created_at` (string): Creation timestamp (ISO 8601)
+  
+  **Status Codes:**
+  - 201: Folder created successfully
+  - 400: Bad request (invalid folder path)
+  - 401: Unauthorized
+  - 403: Forbidden (admin access required)
+  - 500: Internal server error
+  
+  **Features:**
+  - Admin-only endpoint for adding ebook folders
+  - Path normalization for consistent storage
+  - Supports both absolute paths and home directory (~) paths
+  - Prevents duplicate folders for the same user
+}