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:
@@ -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
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user