Startseite
» KODI
»
Wie man einen TMDB-API-Schlüssel erstellt und ihn zu Kodi hinzufügt
Wie man einen TMDB-API-Schlüssel erstellt und ihn zu Kodi hinzufügt
Wenn ein Kodi-Add-on nach Ihren eigenen TMDB-Zugangsdaten fragt, fordern Sie diese über Ihr TMDB-Konto an und geben Sie sie in den Einstellungen des Add-ons ein. Kodi selbst verfügt über kein systemweites Feld für TMDB-API-Schlüssel, daher muss das Add-on einen benutzerdefinierten Schlüssel unterstützen. Ein persönlicher Schlüssel kann hilfreich sein, wenn ein Add-on auf gemeinsam genutzte Zugangsdaten angewiesen ist, umgeht jedoch weder die Ratenbegrenzungen von TMDB noch garantiert er die Behebung von Abstürzen.
Die untenstehenden Abbildungen der Benutzeroberfläche dienen nur der Veranschaulichung. TMDB behält sich das Recht vor, die Kontoeinstellungen zu ändern, und die Kodi-Menüs variieren je nach Skin, Gerät und Add-on.
Bevor Sie beginnen
Sie benötigen ein TMDB-Konto und ein Kodi-Add-on, das die TMDB-API nutzt und eine Einstellung für benutzerdefinierte Anmeldeinformationen bietet. TMDB empfiehlt die Anmeldung über einen Desktop-Browser, da der API-Registrierungsprozess nicht für Mobilgeräte optimiert ist. Die TMDB-Anleitung für Einsteiger erklärt, wo Sie den Zugriff beantragen können und verlinkt zu den Nutzungsbedingungen, die Sie akzeptieren müssen.
TMDB listet zwei Anmeldeinformationen für Anwendungen auf: einen API-Schlüssel (v3-Authentifizierung) und ein API-Lesezugriffstoken (v4-Authentifizierung) . Beide werden in der TMDB als Authentifizierungsmethoden für API-Anfragen beschrieben, jedoch akzeptiert ein bestimmtes Add-on möglicherweise nur eines der beiden Formate. Achten Sie darauf, dass die Anmeldeinformationen dem Feld zugeordnet sind, das das Add-on tatsächlich anfordert. Fügen Sie beispielsweise keinen v3-Schlüssel in ein Feld ein, das explizit ein v4-Bearer-Token verlangt.
So erstellen Sie einen TMDB-API-Schlüssel
Erstellen Sie ein TMDB-Konto oder melden Sie sich an. Besuchen Sie The Movie Database , registrieren Sie sich gegebenenfalls und schließen Sie die angeforderte Kontoverifizierung ab. Melden Sie sich anschließend über einen Desktop-Browser an.
Bevor Sie Zugriff auf die TMDB-API anfordern können, ist ein Konto erforderlich.
Öffnen Sie die API-Einstellungen. Gehen Sie in Ihrem Konto auf „Einstellungen“ und wählen Sie in der Kontonavigation „API“ aus. Die aktuelle TMDB-Dokumentation beschreibt den API-Link als Teil der Kontoeinstellungen; die genaue Position oder Bezeichnung kann sich jedoch ändern.
Suchen Sie den API-Eintrag in Ihren TMDB-Kontoeinstellungen.
Starten Sie eine API-Anfrage. Folgen Sie dem Ablauf auf der API-Seite. Wählen Sie den Anwendungstyp, der Ihrem tatsächlichen Verwendungszweck entspricht, geben Sie eine genaue Beschreibung der Software und Ihrer geplanten API-Nutzung ein und lesen Sie die Nutzungsbedingungen und API-Richtlinien sorgfältig durch, bevor Sie diese akzeptieren. Verwenden Sie keine erfundenen Kontakt- oder Projektinformationen.
Beschreiben Sie den konkreten Anwendungsfall und akzeptieren Sie die Nutzungsbedingungen von TMDB, bevor Sie die Anfrage absenden.
Warten Sie, bis TMDB die Zugangsdaten ausgestellt hat. Sobald der Antrag akzeptiert wurde, kehren Sie zu den API-Einstellungen zurück und überprüfen Sie die beiden Einträge: API-Schlüssel (v3-Authentifizierung) und API-Lesezugriffstoken (v4-Authentifizierung). Dies sind separate Zugangsdaten für Ihre Anwendung. Die verfügbaren Methoden werden
im TMDB-Authentifizierungsleitfaden erläutert.TMDB zeigt den v3-Schlüssel und das v4-Zugriffstoken als separate Anmeldeinformationen an.
Kopieren Sie die Anmeldeinformationen, die Ihr Add-on anfordert. Wenn im Feld „API-Schlüssel“ steht, kopieren Sie den API-Schlüssel (Version 3) . Falls explizit nach einem API-Lesezugriffstoken oder einem Bearer-Token gefragt wird, verwenden Sie stattdessen den entsprechenden Wert (Version 4). Raten Sie nicht zwischen den beiden und geben Sie Ihre Anmeldeinformationen nicht öffentlich in Beiträgen oder Screenshots weiter.
Kopieren Sie den v3-Schlüssel nur dann, wenn das Add-on nach einem API-Schlüssel fragt.
Wie man den Schlüssel in Kodi hinzufügt
Öffnen Sie den Add-ons-Bereich von Kodi. Wählen Sie auf dem Startbildschirm „Add-ons“ und öffnen Sie den Add-on-Browser oder die installierten Add-ons. Namen und Layout können je nach Kodi-Version und -Design variieren.
Beginnen Sie im Add-ons-Bereich von Kodi; das genaue Layout hängt von Ihrem Skin ab.
Öffnen Sie die Einstellungen des kompatiblen Add-ons. Suchen Sie das Add-on, das Film- oder Fernsehmetadaten von TMDB abruft, markieren Sie es, öffnen Sie das Kontextmenü von Kodi und wählen Sie „Einstellungen“. Die Add-on-Dokumentation von Kodi beschreibt diesen Vorgang. Die Bezeichnung des Kontextmenü-Steuerelements kann auf Fernbedienungen oder Geräten abweichen. Vergewissern Sie sich, dass die Dokumentation des Add-ons die Verwendung benutzerdefinierter TMDB-Anmeldeinformationen unterstützt.
Verwenden Sie das Kontextmenü des ausgewählten Add-ons, um zu dessen Einstellungen zu gelangen.
Geben Sie den Schlüssel ein und speichern Sie. Öffnen Sie die Konto-, Metadaten- oder API-Einstellungen des Add-ons und suchen Sie das Feld für den TMDB-API-Schlüssel. Fügen Sie den kopierten Wert ein, prüfen Sie, ob am Anfang oder Ende Leerzeichen hinzugefügt wurden, und wählen Sie „OK“ oder „Speichern“. Falls das Add-on einen anderen Anmeldeinformationstyp verlangt, verwenden Sie den entsprechenden Wert aus der TMDB. Starten Sie das Add-on nur dann neu, wenn in der Dokumentation angegeben ist, dass die Einstellungen nach einem Neustart wirksam werden.
Nur ein kompatibles Add-on bietet ein solches Feld; Kodi hat kein universelles TMDB-Schlüsselfeld.
Falls das Add-on weiterhin Fehler aufweist
Kein API-Schlüsselfeld: Das Add-on unterstützt möglicherweise keine benutzerdefinierten TMDB-Anmeldeinformationen. Kodi bietet keine globale Einstellung, die die Konfiguration des Add-ons ersetzen könnte.
Authentifizierungsfehler: Prüfen Sie, ob der Wert vollständig kopiert wurde und ob Sie den vom Add-on angegebenen Anmeldeinformationstyp verwendet haben. API-Schlüssel und API-Lesezugriffstoken sind unterschiedliche Felder in den TMDB-Kontoeinstellungen.
Ratenbegrenzung oder Verbindungsfehler: Ein persönlicher Schlüssel befreit Anfragen nicht von den Beschränkungen von TMDB. Das Add-on sendet möglicherweise weiterhin zu viele Anfragen, oder TMDB ist vorübergehend nicht verfügbar. Überprüfen Sie das Add-on-Protokoll und den Dienststatus von TMDB, bevor Sie weitere Einstellungen ändern.
Kategorien stürzen weiterhin ab: Ein Schlüssel kann nicht zugehörigen Add-on-Code, eine veraltete Metadatenintegration oder eine fehlerhafte Abhängigkeit reparieren. Aktualisieren Sie nur von einer vertrauenswürdigen Quelle und befolgen Sie die aktuelle Dokumentation des jeweiligen Add-ons. Ältere Anleitungen erwähnen möglicherweise Covenant oder Elysium, aber diese Add-ons haben ihre eigenen Einstellungen und Versionshistorie; ihre Menüpfade gelten nicht für jedes Kodi-Add-on.
Für die nichtkommerzielle Nutzung der API gibt TMDB in seinen API-FAQs an, dass die Daten und Bilder entsprechend gekennzeichnet werden müssen. Kommerzielle Projekte werden gebeten, sich bezüglich der Lizenzierung an TMDB zu wenden. Wenn Sie lediglich ein bestehendes Add-on konfigurieren, befolgen Sie die Anweisungen des Add-on-Entwicklers und veröffentlichen Sie Ihre persönlichen Zugangsdaten nicht.