API

Sarja base.json sisaldab kõiki selle hooaegu ja osi, nii et ühe päringuga saad kogu sarja. Sarja, hooaegade ja osade nimed ning kirjeldused on keelefailides.

Failid

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

Pilt on objekt, millel on teed full ja thumb.

base.json

Väli	Tüüp	Kirjeldus
type	string	Kirje tüüp.
id	number	TheTVDB id.
slug	string	URL-i slug, tüübi piires unikaalne.
popularity	number	TheTVDB populaarsusskoor; suurem tähendab populaarsemat. Skoore saab võrrelda ainult sama tüübi piires.
deleted	boolean	True, kui kirje on eemaldatud. Selle failid jäävad avaldatuks.
firstAired	string	Esimese osa kuupäev (YYYY-MM-DD).
lastAired	string	Viimase osa kuupäev.
status	string	Eetrioleku staatus TheTVDB-st, näiteks Continuing või Ended.
network	string	Telekanal.
originalLanguage	string	Algkeele kood.
originalCountry	string	Päritoluriik (kolmetäheline kood).
image	image	Põhipilt: pealkirjadel plakat, inimestel foto.
images	{ [kind]: image }	Iga liigi parim pilt: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Iga liigi kohta parim pilt igas keeles koos keelekoodi, suuruse ja skooriga.
cast	credit[]	Näitlejad tiitrite järjekorras.
crew	credit[]	Kõik teised tegijad koos ametiga.
topBilledIds	number[]	Esimesena esile tõstetavate inimeste id-d.
seasons	season[]	Hooajad eetrisse jõudmise järjekorras, igaüks koos oma osadega.
genres	string[]	Žanrite slug'id TheTVDB määratluse järgi.
languages	string[]	Keeled, mille jaoks sellel kirjel on failid.
remoteIds	{ [site]: string }	Id-d teistel saitidel (imdb, tmdb, wikidata, …), saidi kaupa.

Näide

{
  "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" }
}

Hooajad

Väli	Tüüp	Kirjeldus
id	number	TheTVDB id.
number	number	Hooaja number; 0 on eriosad.
deleted	boolean	True, kui kirje on eemaldatud. Selle failid jäävad avaldatuks.
image	image	Põhipilt: pealkirjadel plakat, inimestel foto.
images	{ [kind]: image }	Iga liigi parim pilt: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Iga liigi kohta parim pilt igas keeles koos keelekoodi, suuruse ja skooriga.
episodes	episode[]	Hooaja osad.

Osad

Väli	Tüüp	Kirjeldus
id	number	TheTVDB id.
number	number	Osa number hooaja piires.
aired	string	Eetrikuupäev (YYYY-MM-DD).
runtime	number	Kestus minutites.
image	image	Põhipilt: pealkirjadel plakat, inimestel foto.
criticalToStory	boolean	Märgitud loo jaoks oluliseks.
specialType	string	Eriosa liik (hooaja 0 osad).
deleted	boolean	True, kui kirje on eemaldatud. Selle failid jäävad avaldatuks.

Tegijad

Iga kirje väljades cast ja crew:

Väli	Tüüp	Kirjeldus
id	number	Inimese id.
activityId	number	Osaluse id, iga osaluse puhul unikaalne.
role	string	Kehastatud tegelane (näitlejad).
job	string	Amet (meeskond): director, writer, producer, …
slug	string	Inimese slug.
image	image	Inimese foto.
topBilled	boolean	Esiletõstetud osalus.
deleted	boolean	True, kui inimene on eemaldatud.

Keelefailid

Väli	Tüüp	Kirjeldus
type	string	Kirje tüüp.
id	number	TheTVDB id.
lang	string	Selle faili keel.
name	string	Nimi selles keeles.
overview	string	Kirjeldus selles keeles.
credits	{ [personId]: { name, role } }	Inimese id kaupa: tema nimi selles keeles ja roll.
seasons	{ [seasonId]: { name, overview } }	Hooaja id kaupa: selle nimi ja kirjeldus.
episodes	{ [episodeId]: { name, overview } }	Osa id kaupa: selle nimi ja kirjeldus.

Näide

{
  "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…" } }
}

Pealkirja leidmine slug'i järgi

Sarjade ja filmide URL-id kasutavad slug'e (breaking-bad). Slug'ide indeks seob iga slug'i selle id-ga ja on jagatud 256 väikeseks failiks: slug'i fail on nimetatud slug'i SHA-1 esimese kahe kuueteistkümnendmärgi järgi.

// 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())