Hoe vraag je een API-sleutel aan voor TMDB (The Movie Database)?

Inleiding tot TMDB
TMDB (The Movie Database) is een openbare film- en televisiedatabase die uitgebreide gegevens biedt over films, tv-programma's, acteurs en productieteams. TMDB wordt vaak de 'Wikipedia van de film- en tv-industrie' genoemd en stelt gebruikers in staat om bijdragen te leveren door items aan te maken en te bewerken. Het biedt een open API waarmee gebruikers filmposters, samenvattingen en andere metagegevens kunnen ophalen.

De "Theater"-applicatie in UGOS Pro is vooraf geconfigureerd om TMDB als gegevensbron te gebruiken, waardoor handmatige invoer van een API-sleutel niet nodig is. Gebruikers hebben echter ook de mogelijkheid om indien nodig een aangepaste TMDB API-sleutel te configureren.

Opmerkingen: Als u niet bekend bent met het configureren van een TMDB API-sleutel of het wijzigen van de HOST-instellingen, raden we u aan de standaardconfiguratie te behouden. Gebruikers met specifieke vereisten kunnen de instellingen voor de TMDB-gegevensbron indien nodig aanpassen in de console.

Voordelen van het gebruik van een persoonlijke API-sleutel​

1. Garandeert betrouwbare toegang – Een persoonlijk geregistreerde API-sleutel helpt fouten bij het ophalen van gegevens als gevolg van limieten voor openbare API's te voorkomen.
2. Verbetert de servicekwaliteit – Met een persoonlijke API-sleutel kunnen gebruikers taalvoorkeuren, filmbeoordelingssystemen en andere instellingen aanpassen voor nauwkeurigere metagegevens.

Opmerking: het gebruik van TMDB-gegevens moet voldoen aan de gebruiksvoorwaarden van TMDB.

Een TMDB API-sleutel aanvragen​

Volg deze stappen om een TMDB API-sleutel aan te vragen:

1. Ga naar de officiële website van TMDB en log in op uw account. Als u nog geen account hebt, maak er dan eerst een aan.



2. Nadat u bent ingelogd, klikt u op uw "profielavatar" in de rechterbovenhoek en selecteert u [Accountinstellingen].



3. Ga op de pagina [Accountinstellingen] naar het gedeelte [API] in de linkerzijbalk en klik op 'klik hier' onder [API-sleutel aanvragen].



4. Selecteer 'Developer' als accounttype bij het aanmaken van de API-sleutel.



5. Lees de gebruiksvoorwaarden en ga hiermee akkoord. Vul vervolgens de aanvraaggegevens in:

• Type gebruik: selecteer Persoonlijk.
• Naam van de toepassing: kies een eigen naam, bijvoorbeeld UGREEN "Theater".
• Toepassings-URL: voer het IP-adres van uw UGREEN NAS in, bijvoorbeeld http://192.168.1.31. U vindt dit in [Configuratiescherm] > [Netwerk] > [Netwerkverbinding].
• Toepassingsbeschrijving: Geef een korte beschrijving van uw toepassing en hoe u de API gaat gebruiken.

Film and Television Center is een multimediatoepassing voor thuisgebruik, die wordt gebruikt om TMDB-videogegevens en posterafbeeldingen op te halen om een mooie posterwand te maken.

• Persoonlijke gegevens: Voer gegevens in zoals uw thuisadres (deze gegevens worden opgeslagen door TMDB en zijn niet toegankelijk voor Theater).

6. Nadat u het formulier hebt ingevuld, klikt u op 'Verzenden' en wacht u tot TMDB uw API-sleutel heeft gegenereerd.



7. Kopieer de API-sleutel nadat deze is gegenereerd en sla deze op een veilige plaats op. U hebt dit adres later nodig tijdens het configuratieproces.

TMDB-gegevensbron configureren​

1. Open de app 'Theater' en klik op de knop [Instellingen] in de rechterbovenhoek om de instellingenpagina van Theater te openen.

2. Klik op de instellingenpagina op de optie [Gegevensbron]. Zoek The Movie Database (TMDB) en tik erop om het configuratiescherm van TMDB te openen.

3. Zoek op de TMDB-configuratiepagina het invoerveld API-sleutel. Plak de eerder verkregen TMDB API-sleutel in het veld.

4. Klik op de knop [Controleren] om te controleren of de API-sleutel geldig is. Als de test succesvol is, ziet u een bevestigingsbericht dat de verificatie is geslaagd.

1. Klik op [Toepassen] om de configuratie van de TMDB-gegevensbron op te slaan.

Bibliotheekvideo-informatiebron aanpassen​

1. Stel na de configuratie de bron van de bibliotheekvideo-informatie in op TMDB om posters en andere metagegevens op te halen.

2. Ga terug naar de instellingenpagina en klik op de optie [Bibliotheek].

3. Selecteer in de bibliotheeklijst de bibliotheek waarvan u de gegevensbron wilt wijzigen.

4. Klik op de knop [···] aan de rechterkant van de bibliotheek en selecteer [Bewerken].



5. Zoek op de bewerkingspagina de optie [Video-informatie].

6. Houd ingedrukt om de bronnen te verslepen en opnieuw te ordenen, waarbij TMDB de hoogste prioriteit krijgt.



7. Klik op de knop [Toepassen] om de instellingen op te slaan.

Scan de bibliotheek opnieuw​

1. Ga na het opslaan van de instellingen terug naar de bibliotheekpagina.

2. Klik op de knop [···] aan de rechterkant van de mediabibliotheek en selecteer [Scannen].

3. Klik in de scanopties op [Scan en alles vervangen]. Hiermee worden alle bestanden in de mediabibliotheek opnieuw gescand en worden de nieuwste metagegevens en posters opgehaald uit TMDB.



Opmerking: Als uw API-sleutelverificatie succesvol is, hoeft u HOST meestal niet te configureren. De HOST-configuratie wordt gebruikt om het juiste IP-adres van TMDB op te lossen, DNS-vervuiling te omzeilen en stabiele toegang tot de gegevensbron te garanderen.

Over TMDB​

Metadata wordt niet correct weergegeven​

Als metadata na configuratie niet correct wordt weergegeven, probeer dan het volgende:

1. Controleer of de TMDB API-sleutel correct is ingevoerd en opgeslagen.
2. Controleer of de TMDB API-detectie een succesvolle verbinding bevestigt.
3. Controleer of het IP-adres dat is geconfigureerd in de HOST-instellingen correct wordt omgezet.
4. Als het probleem zich blijft voordoen, probeer dan "Alles scannen en vervangen" te gebruiken om de mediabibliotheek handmatig te vernieuwen.

Als het configureren van de TMDB-gegevensbron extra kosten met zich meebrengt​

TMDB biedt basisdiensten gratis aan, maar voor geavanceerde functies of toegang met een hoog volume (zoals frequente metagegevensupdates) moet u een TMDB-account registreren om een API-sleutel te verkrijgen. Raadpleeg de officiële richtlijnen van TMDB voor meer informatie over het gebruiksbeleid.

Over HOST-configuratie​

In sommige regio's kan de API van TMDB problemen ondervinden met DNS-resolutie. Om dit op te lossen, biedt de Theater-app een HOST-configuratieoptie waarmee gebruikers handmatig het juiste IP-adres voor TMDB kunnen toewijzen. Dit omzeilt onjuiste openbare DNS-resolutie en zorgt voor stabiele toegang tot de gegevensbron.

Let op: het configureren van het HOST-bestand is uitsluitend bedoeld om het scrapen van TMDB-metadata te optimaliseren, zodat de Theater-app filmmetadata zoals posters en beschrijvingen nauwkeurig kan ophalen. UGREEN NAS biedt geen videobronnen — gebruikers zijn zelf verantwoordelijk voor het beheren van hun eigen videodownloads en opslag.

Wat kan de HOST-configuratie doen?​

Bij gebruik van de Theater-app is de metadata-scrapingfunctie afhankelijk van externe metadataservices om gedetailleerde filminformatie op te halen.
Vanwege netwerkbeperkingen of problemen met serviceproviders werkt deze scrapingfunctie mogelijk niet altijd correct. Door het HOST-bestand te configureren, kunt u IP-adressen opgeven om die metadatadiensten op te lossen, waardoor potentiële netwerkproblemen effectief worden omzeild en een soepele ophaling van metadata wordt gegarandeerd.

Het IP-adres van TMDB verkrijgen​

1. Ga naar IPADDRESS.COM.

2. Voer api.tmdb.org in de zoekbalk in en druk op Enter.



3. Scroll naar beneden om het IP-adres te zien dat door het systeem is omgezet. Kopieer en sla het goed op, want je hebt het later nodig tijdens het configureren.

HOST-configuratiemethode​

1. Open de app [Theater] en klik op de knop [Instellingen] in de rechterbovenhoek om de instellingeninterface te openen.

2. Klik op [Gegevensbron], selecteer [The Movie Database] en plak het eerder verkregen IP-adres in het invoerveld HOSTS-configuratie. Zorg ervoor dat de indeling correct is: IP-adres + spatie + domeinnaam.

3. Voer in de TMDB-configuratie de HOST in de volgende indeling in, bijvoorbeeld:

52.85.151.18 api.themoviedb.org

1. Nadat u de informatie hebt gecontroleerd, klikt u op "Importeren" om de installatie te voltooien.
2. Klik op "Toepassen" om de wijzigingen op te slaan.