API

base.json serije sadrži sve njezine sezone i epizode, pa jedan zahtjev dohvaća cijelu seriju. Nazivi i opisi serije, sezona i epizoda nalaze se u jezičnim datotekama.

Datoteke

https://api.watchittrackit.com/v1/tv/{id}/base.json
https://api.watchittrackit.com/v1/tv/{id}/{lang}.json
https://api.watchittrackit.com/v1/tv/slugs/{shard}.json

Slika je objekt s putanjama full i thumb.

base.json

Polje	Vrsta	Opis
type	string	Vrsta zapisa.
id	number	TheTVDB id.
slug	string	URL slug, jedinstven unutar vrste.
popularity	number	TheTVDB ocjena popularnosti; viša znači popularnije. Ocjene su usporedive samo unutar iste vrste.
deleted	boolean	True ako je zapis uklonjen. Njegove datoteke ostaju objavljene.
firstAired	string	Datum prve epizode (YYYY-MM-DD).
lastAired	string	Datum najnovije epizode.
status	string	Status emitiranja iz TheTVDB-a, npr. Continuing ili Ended.
network	string	Mreža.
originalLanguage	string	Kod izvornog jezika.
originalCountry	string	Zemlja podrijetla (troslovni kod).
image	image	Glavna slika: plakat za naslove, fotografija za osobe.
images	{ [kind]: image }	Najbolja slika svake vrste: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Za svaku vrstu najbolja slika na svakom jeziku, s kodom jezika, veličinom i ocjenom.
cast	credit[]	Glumci, redoslijedom navođenja.
crew	credit[]	Svi ostali navedeni suradnici, s njihovim poslom.
topBilledIds	number[]	Id-ovi osoba koje treba istaknuti prve.
seasons	season[]	Sezone redoslijedom emitiranja, svaka sa svojim epizodama.
genres	string[]	Slugovi žanrova kako ih definira TheTVDB.
languages	string[]	Jezici za koje ovaj zapis ima datoteke.
remoteIds	{ [site]: string }	Id-ovi na drugim stranicama (imdb, tmdb, wikidata, …), po stranici.

Primjer

{
  "type": "tv",
  "id": 81189,
  "slug": "breaking-bad",
  "popularity": 3287090,
  "deleted": false,
  "firstAired": "2008-01-20",
  "lastAired": "2013-09-29",
  "status": "Ended",
  "images": {
    "poster": { "full": "/images/tv/81189/1340353429.jpg", "thumb": "/images/tv/81189/1340353429.t.jpg" }
  },
  "cast": [
    { "id": 255211, "activityId": 180, "role": "Walter White", "slug": "bryan-cranston", "topBilled": false, "deleted": false }
  ],
  "seasons": [
    {
      "id": 30272, "number": 1, "deleted": false,
      "episodes": [{ "id": 349232, "number": 1, "aired": "2008-01-20", "runtime": 58, "deleted": false }]
    }
  ],
  "genres": ["drama", "crime"],
  "languages": ["de", "en", "fr"],
  "remoteIds": { "imdb": "tt0903747" }
}

Sezone

Polje	Vrsta	Opis
id	number	TheTVDB id.
number	number	Broj sezone; 0 su specijali.
deleted	boolean	True ako je zapis uklonjen. Njegove datoteke ostaju objavljene.
image	image	Glavna slika: plakat za naslove, fotografija za osobe.
images	{ [kind]: image }	Najbolja slika svake vrste: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Za svaku vrstu najbolja slika na svakom jeziku, s kodom jezika, veličinom i ocjenom.
episodes	episode[]	Epizode sezone.

Epizode

Polje	Vrsta	Opis
id	number	TheTVDB id.
number	number	Broj epizode unutar sezone.
aired	string	Datum emitiranja (YYYY-MM-DD).
runtime	number	Trajanje u minutama.
image	image	Glavna slika: plakat za naslove, fotografija za osobe.
criticalToStory	boolean	Označeno kao ključno za radnju.
specialType	string	Vrsta specijala (epizode sezone 0).
deleted	boolean	True ako je zapis uklonjen. Njegove datoteke ostaju objavljene.

Zasluge

Svaki unos u cast i crew:

Polje	Vrsta	Opis
id	number	Id osobe.
activityId	number	Id zasluge, jedinstven za svaku zaslugu.
role	string	Utjelovljeni lik (glumci).
job	string	Posao (ekipa): director, writer, producer, …
slug	string	Slug osobe.
image	image	Fotografija osobe.
topBilled	boolean	Istaknuta zasluga.
deleted	boolean	True ako je osoba uklonjena.

Jezične datoteke

Polje	Vrsta	Opis
type	string	Vrsta zapisa.
id	number	TheTVDB id.
lang	string	Jezik ove datoteke.
name	string	Naziv na ovom jeziku.
overview	string	Opis na ovom jeziku.
credits	{ [personId]: { name, role } }	Po id-u osobe: njezino ime na ovom jeziku i uloga.
seasons	{ [seasonId]: { name, overview } }	Po id-u sezone: njezin naziv i opis.
episodes	{ [episodeId]: { name, overview } }	Po id-u epizode: njezin naziv i opis.

Primjer

{
  "type": "tv",
  "id": 81189,
  "lang": "en",
  "name": "Breaking Bad",
  "overview": "When Walter White, a chemistry teacher, …",
  "credits": { "255211": { "name": "Bryan Cranston", "role": "Walter White" } },
  "seasons": { "30272": { "overview": "High school chemistry teacher Walter White…" } },
  "episodes": { "349232": { "name": "Pilot", "overview": "When an unassuming high school chemistry teacher…" } }
}

Pronalaženje naslova po slugu

URL-ovi serija i filmova koriste slugove (breaking-bad). Indeks slugova povezuje svaki slug s njegovim id-om i podijeljen je u 256 malih datoteka: datoteka sluga nazvana je po prva dva heksadecimalna znaka SHA-1 vrijednosti sluga.

// Node.js
import { createHash } from "node:crypto"

const slug = "breaking-bad"
const shard = createHash("sha1").update(slug, "utf8").digest("hex").slice(0, 2)
const index = await fetch(`https://api.watchittrackit.com/v1/tv/slugs/${shard}.json`).then((r) => r.json())
const id = index[slug]
const record = await fetch(`https://api.watchittrackit.com/v1/tv/${id}/base.json`).then((r) => r.json())