john-okeefe
af3c3019cf
- Remove obsolete scenarios/ folder and move requests to root media-items/ - Create new filters/ folder for field value autocomplete searches - Move Field Values Search requests from search/ to filters/ for clarity - Move Search Media Items from scenarios/ to search/ for consistency - Update sequence numbers across all media-items requests (2-13) - Remove redundant folder configuration files - Improve API collection organization for better discoverability
52 lines
1.4 KiB
YAML
52 lines
1.4 KiB
YAML
info:
|
|
name: List Media Items
|
|
type: http
|
|
seq: 1
|
|
|
|
http:
|
|
method: GET
|
|
url: "{{base_url}}/api/media-items?library_id={{library_id}}&limit=20&offset=0"
|
|
headers:
|
|
- name: ""
|
|
value: application/json
|
|
auth: inherit
|
|
|
|
settings:
|
|
encodeUrl: true
|
|
timeout: 0
|
|
followRedirects: true
|
|
maxRedirects: 5
|
|
|
|
docs: |-
|
|
## List Media Items
|
|
|
|
Retrieves a paginated list of media items from a specific library.
|
|
|
|
**Method:** GET
|
|
|
|
**Endpoint:** /api/media-items
|
|
|
|
**Authentication:** Required (Bearer token)
|
|
|
|
**Query Parameters:**
|
|
- `library_id` (string, required): Library UUID to filter items
|
|
- `limit` (number, optional): Number of results per page (default: 20, max: 100)
|
|
- `offset` (number, optional): Pagination offset (default: 0)
|
|
|
|
**Response:** Array of media item objects
|
|
- `id` (string): Media item UUID
|
|
- `title` (string): Media item title
|
|
- `library_id` (string): Library UUID
|
|
- `media_type` (string): Type of media (e.g., "ebook", "audiobook")
|
|
- `file_path` (string): Path to media file
|
|
- `created_at` (string): Creation timestamp
|
|
- `updated_at` (string): Last update timestamp
|
|
|
|
**Status Codes:**
|
|
- 200: Success
|
|
- 400: Invalid query parameters
|
|
- 401: Unauthorized
|
|
- 403: Forbidden (library access denied)
|
|
- 404: Library not found
|
|
- 500: Internal server error
|