FilmTotaal ontwikkelaar-API's
FilmTotaal biedt ontwikkelaars gratis toegang tot haar films op Televisie database via een API. Hiermee kan het totale aanbod van televisiefilms voor vandaag en morgen verkregen worden. Als je gebruik wilt maken van onze API's vraag dan een gratis API sleutel aan (lees de voorwaarden).
Algemeen
De FilmTotaal API werkt via een HTTP-request. je stuurt een HTTP-request naar onze server waarbij je de gewenste variabelen meestuurt. De resultaten van de aanvraag worden vervolgens weergeven in XML formaat.
Om requests te kunnen versturen dien je in het bezit te zijn van een API sleutel. Deze kan je gratis aanvragen.
Films op TV API
Een request naar de TV-films API begint altijd met:
http://api.filmtotaal.nl/filmsoptv.xml?apikey=...&dag=...&sorteer=...
De parameters apikey, dag en sorteer dienen verplicht meegestuurd te worden bij iedere request.
- Aan de parameter apikey geeft je de eigen unieke API sleutel mee.
- Aan de parameter dag geeft je de datum mee geschreven als: 21-03-2023. Je kunt alleen een request doen naar de TV-films voor vandaag en morgen.
- Aan de parameter sorteer geeft je mee welke films je wilt ophalen. Dit is het getal 0, 1 of 2. Waar 0 staat voor: alle films, 1 staat voor: filmtips, 2 staat voor: 'film van de dag'.
De TV-films API geeft je momenteel de volgende informatie:
- FilmTotaal link
- Filmtitel
- Jaar
- Regisseur(s)
- Cast (maximaal 6 acteurs en/of actrices)
- Genres(s)
- land(en)
- Cover (afmetingen verschillen)
- Tagline
- Filmduur
- Synopsis
- FT rating
- FT stemmen
- IMDB id
- IMDB rating
- IMDB stemmen
- Starttijd (timestamp)
- Eindtijd (timestamp)
- Zender
- Filmtip (0=geen / 1=tip)
Mocht je vragen/wensen of ideeën hebben m.b.t tot deze API neem dan contact met ons op.
