API

base.json filma sadrži podatke neovisne o jeziku i zasluge; nazivi i opisi nalaze se u jezičnim datotekama.

Datoteke

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

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.
released	string	Datum izlaska (YYYY-MM-DD).
runtime	number	Trajanje u minutama.
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.
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": "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" }
}

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.

Primjer

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

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 = "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())