MyFavMirrors/owntone-server
1
0
Fork 0
mirror of https://github.com/owntone/owntone-server.git synced 2025-02-28 13:59:18 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1736 from johtani/update-search-term-doc

Browse Source 
[docs] Fix the result types in "Search by search term"

Indeed, that's correct. Thanks for the catch.
This commit is contained in:
Alain Nussbaumer 2024-03-26 15:41:21 +01:00 committed by GitHub
commit d6f08a2d70
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/json-api.md
View File

@ -2096,14 +2096,14 @@ curl -X PUT "http://localhost:3689/api/library/backup"
| Method | Endpoint | Description | | Method | Endpoint | Description |
| --------- | ----------------------------------------------------------- | ------------------------------------ | | --------- | ----------------------------------------------------------- | ------------------------------------ |
| GET | [/api/search](#search-by-search-term) | Search for playlists, artists, albums, tracks,genres by a simple search term | | GET | [/api/search](#search-by-search-term) | Search for playlists, artists, albums, tracks, composers by a simple search term |
| GET | [/api/search](#search-by-query-language) | Search by complex query expression | | GET | [/api/search](#search-by-query-language) | Search by complex query expression |
### Search by search term ### Search by search term
Search for playlists, artists, albums, tracks, genres that include the given query in their title (case insensitive matching). Search for playlists, artists, albums, tracks, composers that include the given query in their title (case insensitive matching).
**Endpoint** **Endpoint**
@ -2116,7 +2116,7 @@ GET /api/search
| Parameter | Value | | Parameter | Value |
| --------------- | ----------------------------------------------------------- | | --------------- | ----------------------------------------------------------- |
| query | The search keyword | | query | The search keyword |
| type | Comma separated list of the result types (`playlist`, `artist`, `album`, `track`, `genre`) | | type | Comma separated list of the result types (`playlist`, `artist`, `album`, `track`, `composers`) |
| media_kind | *(Optional)* Filter results by media kind (`music`, `movie`, `podcast`, `audiobook`, `musicvideo`, `tvshow`). Filter only applies to artist, album and track result types. | | media_kind | *(Optional)* Filter results by media kind (`music`, `movie`, `podcast`, `audiobook`, `musicvideo`, `tvshow`). Filter only applies to artist, album and track result types. |
| offset | *(Optional)* Offset of the first item to return for each type | | offset | *(Optional)* Offset of the first item to return for each type |
| limit | *(Optional)* Maximum number of items to return for each type | | limit | *(Optional)* Maximum number of items to return for each type |
@ -2129,6 +2129,7 @@ GET /api/search
| artists | object | [`paging`](#paging-object) object containing [`artist`](#artist-object) objects that matches the `query` | | artists | object | [`paging`](#paging-object) object containing [`artist`](#artist-object) objects that matches the `query` |
| albums | object | [`paging`](#paging-object) object containing [`album`](#album-object) objects that matches the `query` | | albums | object | [`paging`](#paging-object) object containing [`album`](#album-object) objects that matches the `query` |
| playlists | object | [`paging`](#paging-object) object containing [`playlist`](#playlist-object) objects that matches the `query` | | playlists | object | [`paging`](#paging-object) object containing [`playlist`](#playlist-object) objects that matches the `query` |
| composers | object | [`paging`](#paging-object) object containing `composers` objects that matches the `query` |
**Example** **Example**