Metadaten ohne Einrichtung — mit Lese-Token statt API-Schlüssel
Halo bringt einen TMDB-Zugang mit. Wer den Server startet, bekommt Titel, Beschreibungen und Plakate, ohne irgendwo ein Konto anzulegen. Am echten Dienst nachgewiesen: „Der Untergang" (2004) mit deutscher Beschreibung, „Blade Runner 2049" (2017), Plakate als JPEG aus Halos eigener Ablage. **Warum überhaupt die Frage stand.** Jellyfin liefert ebenfalls einen Schlüssel mit — fest im Quellcode, offen im Repository, Konstante `ApiKey` in `TmdbUtils.cs`. Ein Abkommen mit TMDB dazu liess sich nicht belegen: deren Bedingungen erwähnen das Teilen von Schlüsseln mit keinem Wort, und die einzige Äusserung eines Moderators zu genau dieser Frage im TMDB-Forum ging nicht darauf ein, sondern wies nur darauf hin, dass Missbrauch zur Sperrung führt. Geduldet also, nicht gesegnet. Deshalb **mit Ausweg**: wer einen eigenen Zugang hinterlegt, benutzt den. Würde der mitgelieferte je gesperrt, steht damit nicht jede Installation still. **Ein Lese-Token, kein API-Schlüssel.** TMDBs eigene Dokumentation bestätigt, dass er auch an den v3-Endpunkten gilt. Zwei Gründe, und beide zählen bei einem Zugang, der öffentlich im Repo steht: er kann nur lesen, und er geht als `Authorization`-Kopfzeile hinaus statt als `?api_key=` in der Adresse — und eine Adresse steht in jedem Zugriffsprotokoll und jedem Reverse Proxy. Der ältere Schlüssel wird weiterhin angenommen; er kann nur in die Adresse. **Der Hinweis auf TMDB ist Bedingung.** Logo und ein fester Satz, so verlangt es deren Lizenz. `system/info` liefert beides ohne Anmeldung, damit ein Client es auch auf dem Anmeldebildschirm zeigen kann. Das fehlte bisher. --- **Zwei Funde, beide nur durch einen echten Lauf sichtbar:** *„Dark" wurde zu „Dark Shadows" von 1966.* TMDB sortiert nach Beliebtheit, und ohne Jahresangabe führt das in die Irre. Jetzt sticht ein Treffer mit genau diesem Namen den beliebteren — danach: „Dark" (2017), deutsche Beschreibung, Folgentitel „Geheimnisse" und „Lügen". Nur bei Gleichheit, nicht bei Ähnlichkeit: eine eigene Bewertung wäre TMDBs Rangfolge nachgebaut, mit weniger Daten. *Die Tests griffen plötzlich übers Netz zu.* Sobald ein Schlüssel mitgeliefert wird, fragt jeder Scan wirklich bei TMDB nach — und prompt hiess „Der Untergang" im Test „Downfall", weil die Voreinstellung Englisch ist. Genau das, was ein Testwerk nicht tun darf: am WLAN hängen und an fremden Daten. Der Anbieter ist jetzt für alle Tests abgeschaltet, ausser ein Test schiebt ausdrücklich einen eigenen nach. 238 Tests grün, keiner davon geht ins Netz. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
co-authored by
Claude Opus 5
Claude Opus 5
parent
e4a90fce4e
commit
79b6001f86
@@ -41,13 +41,23 @@ public sealed class TmdbClient(
|
||||
|
||||
private static readonly JsonSerializerOptions Json = new(JsonSerializerDefaults.Web);
|
||||
|
||||
/// <summary>Ein Lese-Token ist ein JWT und fängt immer so an.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Damit beides funktioniert, was auf TMDBs Kontoseite steht.</b> Dort
|
||||
/// liegen zwei Dinge nebeneinander — „API Key" und „API Read Access
|
||||
/// Token" —, und wer eines davon kopiert, soll nicht erst herausfinden
|
||||
/// müssen, welches gemeint war.
|
||||
/// </remarks>
|
||||
private const string JwtAnfang = "eyJ";
|
||||
|
||||
public async Task<bool> IsConfiguredAsync(CancellationToken ct = default) =>
|
||||
!string.IsNullOrWhiteSpace((await einstellungen.GetAsync(ct)).ApiKey);
|
||||
|
||||
public async Task<MovieMetadata?> FindMovieAsync(string title, int? year, CancellationToken ct = default)
|
||||
{
|
||||
var treffer = await SuchenAsync<TmdbMovie>("search/movie", title,
|
||||
year is { } j ? ("year", j.ToString()) : null, ct);
|
||||
year is { } j ? ("year", j.ToString()) : null, m => m.Title, ct);
|
||||
if (treffer is null) return null;
|
||||
|
||||
return new MovieMetadata(
|
||||
@@ -62,7 +72,7 @@ public sealed class TmdbClient(
|
||||
public async Task<SeriesMetadata?> FindSeriesAsync(string title, int? year, CancellationToken ct = default)
|
||||
{
|
||||
var treffer = await SuchenAsync<TmdbSeries>("search/tv", title,
|
||||
year is { } j ? ("first_air_date_year", j.ToString()) : null, ct);
|
||||
year is { } j ? ("first_air_date_year", j.ToString()) : null, s => s.Name, ct);
|
||||
if (treffer is null) return null;
|
||||
|
||||
return new SeriesMetadata(
|
||||
@@ -81,40 +91,73 @@ public sealed class TmdbClient(
|
||||
if (string.IsNullOrWhiteSpace(einstellung.ApiKey)) return null;
|
||||
|
||||
var pfad = $"tv/{seriesProviderId}/season/{season}/episode/{episode}" +
|
||||
$"?api_key={Uri.EscapeDataString(einstellung.ApiKey)}" +
|
||||
$"&language={Uri.EscapeDataString(einstellung.Language)}";
|
||||
$"?language={Uri.EscapeDataString(einstellung.Language)}";
|
||||
|
||||
var folge = await HolenAsync<TmdbEpisode>(pfad, ct);
|
||||
var folge = await HolenAsync<TmdbEpisode>(pfad, einstellung, ct);
|
||||
if (folge is null) return null;
|
||||
|
||||
return new EpisodeMetadata(Leer(folge.Name), Leer(folge.Overview), Bild(folge.StillPath, StillSize));
|
||||
}
|
||||
|
||||
private async Task<T?> SuchenAsync<T>(
|
||||
string pfad, string titel, (string Name, string Wert)? zusatz, CancellationToken ct) where T : class
|
||||
string pfad, string titel, (string Name, string Wert)? zusatz,
|
||||
Func<T, string?> titelVon, CancellationToken ct) where T : class
|
||||
{
|
||||
var einstellung = await einstellungen.GetAsync(ct);
|
||||
if (string.IsNullOrWhiteSpace(einstellung.ApiKey) || string.IsNullOrWhiteSpace(titel)) return null;
|
||||
|
||||
var abfrage = $"{pfad}?api_key={Uri.EscapeDataString(einstellung.ApiKey)}" +
|
||||
$"&language={Uri.EscapeDataString(einstellung.Language)}" +
|
||||
var abfrage = $"{pfad}?language={Uri.EscapeDataString(einstellung.Language)}" +
|
||||
$"&query={Uri.EscapeDataString(titel)}";
|
||||
if (zusatz is { } z) abfrage += $"&{z.Name}={Uri.EscapeDataString(z.Wert)}";
|
||||
|
||||
var antwort = await HolenAsync<TmdbSearch<T>>(abfrage, ct);
|
||||
var antwort = await HolenAsync<TmdbSearch<T>>(abfrage, einstellung, ct);
|
||||
var treffer = antwort?.Results;
|
||||
if (treffer is null || treffer.Count == 0) return null;
|
||||
|
||||
// **Der erste Treffer, nicht der beste.** TMDB sortiert nach
|
||||
// Beliebtheit, und das ist für einen Titel mit Jahr fast immer richtig.
|
||||
// Eine eigene Bewertung zu bauen hiesse, TMDBs Rangfolge nachzubauen —
|
||||
// mit weniger Daten.
|
||||
return antwort?.Results?.FirstOrDefault();
|
||||
// **Ein genau passender Name sticht den beliebtesten.**
|
||||
//
|
||||
// TMDB sortiert nach Beliebtheit. Ohne Jahresangabe führt das in die
|
||||
// Irre: die Suche nach „Dark" lieferte „Dark Shadows" von 1966 statt
|
||||
// der Serie von 2017 — am echten Dienst gemessen, nicht vermutet.
|
||||
// Steht ein Treffer mit genau diesem Namen in der Liste, ist er
|
||||
// gemeint.
|
||||
//
|
||||
// Nur bei Gleichheit, nicht bei Ähnlichkeit: eine eigene Bewertung zu
|
||||
// bauen hiesse, TMDBs Rangfolge nachzubauen — mit weniger Daten.
|
||||
var genau = treffer.FirstOrDefault(e =>
|
||||
string.Equals(titelVon(e)?.Trim(), titel.Trim(), StringComparison.OrdinalIgnoreCase));
|
||||
|
||||
return genau ?? treffer[0];
|
||||
}
|
||||
|
||||
private async Task<T?> HolenAsync<T>(string pfadMitAbfrage, CancellationToken ct) where T : class
|
||||
/// <summary>Holt eine Antwort — mit Bearer, wo es geht.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Der Lese-Token wandert in die Kopfzeile, nicht in die Adresse.</b>
|
||||
/// Ein <c>?api_key=…</c> steht in jedem Zugriffsprotokoll, in jedem
|
||||
/// Reverse Proxy und in jeder Fehlermeldung, die eine Adresse zitiert.
|
||||
/// Eine Kopfzeile tut das nicht. Dazu kann ein Lese-Token nichts ändern,
|
||||
/// nur lesen — bei einem Schlüssel, der in einem offenen Projekt
|
||||
/// mitgeliefert wird, ist das der Unterschied, auf den es ankommt.
|
||||
///
|
||||
/// Der ältere Schlüssel geht trotzdem: er kann nur in die Adresse.
|
||||
/// </remarks>
|
||||
private async Task<T?> HolenAsync<T>(
|
||||
string pfadMitAbfrage, TmdbSettings einstellung, CancellationToken ct) where T : class
|
||||
{
|
||||
var zugang = einstellung.ApiKey!;
|
||||
var alsBearer = zugang.StartsWith(JwtAnfang, StringComparison.Ordinal);
|
||||
var adresse = alsBearer
|
||||
? pfadMitAbfrage
|
||||
: pfadMitAbfrage + (pfadMitAbfrage.Contains('?') ? "&" : "?")
|
||||
+ $"api_key={Uri.EscapeDataString(zugang)}";
|
||||
|
||||
try
|
||||
{
|
||||
using var antwort = await http.GetAsync(pfadMitAbfrage, ct);
|
||||
using var anfrage = new HttpRequestMessage(HttpMethod.Get, adresse);
|
||||
if (alsBearer) anfrage.Headers.Authorization = new("Bearer", zugang);
|
||||
|
||||
using var antwort = await http.SendAsync(anfrage, ct);
|
||||
|
||||
if (antwort.StatusCode is HttpStatusCode.Unauthorized or HttpStatusCode.Forbidden)
|
||||
throw new MetadataCredentialsException(
|
||||
@@ -126,7 +169,7 @@ public sealed class TmdbClient(
|
||||
|
||||
if (!antwort.IsSuccessStatusCode)
|
||||
{
|
||||
log.LogWarning("TMDB antwortete mit {Code} auf {Pfad}.", (int)antwort.StatusCode, Gekürzt(pfadMitAbfrage));
|
||||
log.LogWarning("TMDB antwortete mit {Code} auf {Pfad}.", (int)antwort.StatusCode, Gekürzt(adresse));
|
||||
return null;
|
||||
}
|
||||
|
||||
@@ -136,7 +179,7 @@ public sealed class TmdbClient(
|
||||
catch (OperationCanceledException) when (ct.IsCancellationRequested) { throw; }
|
||||
catch (Exception fehler)
|
||||
{
|
||||
log.LogWarning(fehler, "TMDB war für {Pfad} nicht erreichbar.", Gekürzt(pfadMitAbfrage));
|
||||
log.LogWarning(fehler, "TMDB war für {Pfad} nicht erreichbar.", Gekürzt(adresse));
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user