docs: describe the YouTube Music search timeout [skip ci]

This commit is contained in:
TapTap committed 2026-11-16 18:40:14 +00:00
1 parent 515b9bbe1b
commit 81a47f4cd2
1 file changed
+5 -4
+5 -4
View File
@@ -333,14 +333,15 @@ directory and the cover. Run GC:
### 4.7 Search and URL adds
- `GET /api/v1/search?q=...&limit=...` -> YT results with `videoId,title,
artist,album,duration,thumbnail,songId?,downloaded`.
- `GET /api/v1/search?q=...&limit=...` -> YouTube Music song results with
`videoId,title,artist,album,duration,thumbnail,songId?,downloaded,inMood`.
- Hide results with `duration > 600` seconds (and probably `< 30`).
- `POST /api/v1/moods/{id}/songs` accepts either `songId` (existing download)
or download metadata, or `url`. A URL is resolved with yt-dlp
(`--dump-single-json --no-playlist`) before enqueueing.
- Search requires auth; it is a server-side yt-dlp call, so use a 120s client
timeout and return 502 with the yt-dlp error on failure.
- Search requires auth; it is a server-side yt-dlp call that resolves every
Music result, so use a 60s client timeout and return 502 with the yt-dlp
error on failure.
### 4.8 API surface