Watch It? Track It.

API

A Watch It? Track It. minden adata statikus JSON fájlokként érhető el, amelyeket közvetlenül letölthetsz. Nincs API-kulcs és nincs megtanulandó kérésformátum: minden rekord egy fájl egy kiszámítható URL-en.

Minden fájl innen érhető el:

https://api.watchittrackit.com

Hogyan működik

  • Minden rekordnak van egy base.json fájlja a nyelvfüggetlen adatokkal, és nyelvenként egy fájlja (en.json, de.json, …) a nevekkel és leírásokkal.
  • A rekordokat típus és TheTVDB-azonosító alapján lehet elérni. A sorozatok és filmek oldalai slugokat használnak; a slugindex a slugot azonosítóvá alakítja.
  • A fájlok helyben változnak, amikor egy rekordot szerkesztenek az oldalon, vagy frissül a TheTVDB-ből (naponta). A változások olcsó ellenőrzéséhez küldj If-None-Match fejlécet a fájl legutóbbi ETag értékével.
  • A képek elérési útjai relatívak: írd eléjük az alap URL-t. Minden képnek van teljes méretű változata és bélyegképe.
  • A törölt rekordok "deleted": true értékkel továbbra is elérhetők maradnak.
  • Bárhonnan hívhatod, akár a saját oldalad böngészős kódjából is: minden fájl Access-Control-Allow-Origin: * fejléccel érkezik.
curl https://api.watchittrackit.com/v1/tv/81189/base.json
curl https://api.watchittrackit.com/v1/tv/81189/en.json

Licencelés

Az adatok felhasználásának licence a következő:

  • Nem kereskedelmi projektek és startupok: ingyenes.
  • Nyereséges kereskedelmi projektek, legfeljebb 1 millió USD nettó céges vagyon esetén: havi 100 USD.
  • Nyereséges kereskedelmi projektek, 1 millió USD feletti nettó céges vagyon esetén: havi 1000 USD.

Kereskedelmi célú felhasználás licenceléséhez fordulj Scott Zsorihoz: scott@watchittrackit.com.

Adatfájlok