feat: create Bruno requests for library system API

- Add library management requests (CRUD operations)
- Create media items API requests for library content
- Implement library visibility controls
- Add user library access management
- Update deprecated ebook folder endpoints with migration guide
- Include comprehensive documentation and test cases
- Replace collection.bru with proper dashboard request

Complete Bruno collection supporting new multi-library architecture
This commit is contained in:
2026-01-28 11:15:36 -05:00
parent 84d846ae6c
commit 81fa177fe6
14 changed files with 285 additions and 48 deletions
+16 -18
View File
@@ -16,31 +16,29 @@ settings {
}
docs {
## Get Ebook Folders
## Get Ebook Folders - DEPRECATED
Retrieves all ebook folders configured for the authenticated user.
⚠️ **This endpoint is deprecated and will return HTTP 410 Gone.**
**Method:** GET
**Use the new library system instead:**
- Use `/api/libraries` to manage libraries
- Use `/api/libraries/{id}/folders` to manage library folders
**Endpoint:** /api/auth/ebook-folders
**Migration Path:**
1. Create a library of type "ebooks"
2. Add your ebook folders to that library
3. Use library visibility controls instead of user-specific folders
**Authentication:** Required (Admin only)
**Response:** Array of folder objects 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)
**Response:** HTTP 410 Gone with deprecation message
**Status Codes:**
- 200: Success (empty array if no folders found)
- 410: Gone (endpoint deprecated)
- 401: Unauthorized
- 403: Forbidden (admin access required)
- 500: Internal server error
**Features:**
- Admin-only endpoint for retrieving configured folders
- Returns all folders configured for the user
- Useful for folder management interfaces
- Empty array returned if no folders configured
**Replacement Endpoints:**
- `GET /api/libraries` - List all libraries (admin)
- `GET /api/libraries/visible` - List user's visible libraries
- `POST /api/libraries` - Create new library
- `POST /api/libraries/{id}/folders` - Add folder to library
}