docs(jellyfin): the door that scans is /Library/Refresh, and the art door names its field #120

Merged
dank merged 4 commits from docs/jellyfin-scan-door into main 2026-11-02 07:16:53 -08:00
Showing only changes of commit 8889a4ceff - Show all commits
@@ -130,6 +130,13 @@ nothing to look up. Art coverage is capped by identification, not by the image d
the items a campaign returns nothing for are the unidentified ones, and no image the items a campaign returns nothing for are the unidentified ones, and no image
retry will change that. retry will change that.
**Series and season art is fetched; episode stills are not, deliberately.** Every
episode query is a fresh provider round-trip — nothing caches per episode — measured
at ~11 s per item beside ~2 s per series on the same host, with one hit in five in a
sample. Across 42k episodes that is days of provider traffic to dress a fifth of them,
and clients display the series and season art anyway. If episode stills are ever
ordered, the loop is the same door and its log makes the pass resumable.
**API shape on 12.x:** `/Items` and `/Items/{id}` need `UserId` when **API shape on 12.x:** `/Items` and `/Items/{id}` need `UserId` when
authenticated by API key — without it the answer is `400 Error processing authenticated by API key — without it the answer is `400 Error processing
request`, which reads exactly like an authentication failure. `MetadataRefreshMode` request`, which reads exactly like an authentication failure. `MetadataRefreshMode`