API

Filmi base.json sisaldab keelest sõltumatuid andmeid ja tegijaid; nimed ja kirjeldused on keelefailides.

Failid

https://api.watchittrackit.com/v1/movie/{id}/base.json
https://api.watchittrackit.com/v1/movie/{id}/{lang}.json
https://api.watchittrackit.com/v1/movie/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.
released	string	Ilmumiskuupäev (YYYY-MM-DD).
runtime	number	Kestus minutites.
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.
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": "movie",
  "id": 16612,
  "slug": "barbie",
  "popularity": 1213687,
  "deleted": false,
  "released": "2023-07-18",
  "runtime": 114,
  "images": {
    "poster": { "full": "/images/movie/16612/poster/64ba61bb1dc73.jpg", "thumb": "/images/movie/16612/poster/64ba61bb1dc73.t.jpg" }
  },
  "imagesByLang": {
    "poster": [{ "full": "/images/movie/16612/poster/64ba61bb1dc73.jpg", "thumb": "…", "lang": "eng", "width": 680, "height": 1000, "score": 100007 }]
  },
  "cast": [
    { "id": 327479, "activityId": 44, "role": "Barbie", "slug": "margot-robbie", "topBilled": true, "deleted": false }
  ],
  "crew": [
    { "id": 569546, "activityId": 93, "job": "producer", "slug": "walter-f-parkes", "topBilled": false, "deleted": false }
  ],
  "topBilledIds": [327479],
  "genres": ["adventure", "comedy", "fantasy"],
  "languages": ["de", "en", "fr"],
  "remoteIds": { "imdb": "tt1517268", "tmdb": "346698" }
}

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.

Näide

{
  "type": "movie",
  "id": 16612,
  "lang": "en",
  "name": "Barbie",
  "overview": "Barbie and Ken are having the time of their lives…",
  "credits": { "327479": { "name": "Margot Robbie", "role": "Barbie" } }
}

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 = "barbie"
const shard = createHash("sha1").update(slug, "utf8").digest("hex").slice(0, 2)
const index = await fetch(`https://api.watchittrackit.com/v1/movie/slugs/${shard}.json`).then((r) => r.json())
const id = index[slug]
const record = await fetch(`https://api.watchittrackit.com/v1/movie/${id}/base.json`).then((r) => r.json())