refactor: reorganize Bruno API collection into subdirectories

- Move search-related requests into bruno/media-items/search/ subdirectory
- Rename Fuzzy Genre Filter.yml to Fuzzy Tags Filter.yml
- Keep scenario-based requests in bruno/media-items/scenarios/
- Improve collection organization and discoverability

This reorganization makes the Bruno API collection more organized by
grouping search endpoints together and updating genre filter to tags filter.
This commit is contained in:
2026-03-25 20:40:25 -04:00
parent a64f14047d
commit f28dca1334
10 changed files with 0 additions and 0 deletions
@@ -0,0 +1,89 @@
info:
name: Field Values Search - Series
type: http
seq: 9
http:
method: GET
url: "{{base_url}}/api/media-items/search?library_id={{library_id}}&series=foundation&limit=50"
params:
- name: library_id
value: "{{library_id}}"
type: query
- name: series
value: foundation
type: query
- name: limit
value: "50"
type: query
auth: inherit
settings:
encodeUrl: true
timeout: 0
followRedirects: true
maxRedirects: 5
docs: |-
## Field Values Search - Series
Fetches distinct series values for autocomplete dropdowns with counts and similarity scores.
**Method:** GET
**Endpoint:** /api/media-items/search
**Authentication:** Required (Bearer token)
**Query Parameters:**
- `library_id` (string, required): Library UUID to search within
- `series` (string, required): Series name to search for (fuzzy match)
- `limit` (integer, optional): Maximum results to return (default: 50)
**How It Works:**
- Returns distinct series names from the library
- Fuzzy matches the search query against series names
- Includes count of books per series
- Includes similarity score (0-1, higher = better match)
- Sorted by similarity score, then by count
**Use Case:**
- Populate autocomplete dropdown when user types in series filter field
- Show user available series with book counts
- Help users discover similar series names
**Response:** HTTP 200 (OK)
```json
{
"results": [
{
"value": "Foundation",
"count": 7,
"score": 0.9
},
{
"value": "Foundation Series",
"count": 7,
"score": 0.85
}
],
"total": 2
}
```
**Examples:**
- `series=foundation` → Returns "Foundation" (7 books), "Foundation Series" (7 books)
- `series=harry` → Returns "Harry Potter" (10 books)
- `series=lord` → Returns "Lord of the Rings" (3 books)
**Frontend Integration:**
- Call this endpoint when user types ≥2 characters in series field
- Display results in `<datalist>` or custom dropdown
- Show: "Series Name (count)" format
- Allow user to select from suggestions
**Success Criteria:**
- Status: 200
- Returns array of series values with counts
- Results sorted by relevance (similarity score)
- Only returns series matching the fuzzy search