API

base.json i një filmi përmban të dhënat e tij të pavarura nga gjuha dhe pjesëmarrësit; emrat dhe përshkrimet janë në skedarët e gjuhëve.

Skedarët

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

Një imazh është një objekt me shtigjet full dhe thumb.

base.json

Fusha	Lloji	Përshkrimi
type	string	Lloji i regjistrimit.
id	number	Id-ja në TheTVDB.
slug	string	Slug-u i URL-së, unik brenda llojit.
popularity	number	Pikët e popullaritetit nga TheTVDB; më e lartë do të thotë më popullor. Pikët krahasohen vetëm brenda të njëjtit lloj.
deleted	boolean	True nëse regjistrimi është hequr. Skedarët e tij mbeten të publikuar.
released	string	Data e publikimit (YYYY-MM-DD).
runtime	number	Kohëzgjatja në minuta.
image	image	Imazhi kryesor: poster për titujt, foto për personat.
images	{ [kind]: image }	Imazhi më i mirë i çdo lloji: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Për çdo lloj, imazhi më i mirë në secilën gjuhë, me kodin e gjuhës, madhësinë dhe pikët.
cast	credit[]	Aktorët, sipas renditjes në titra.
crew	credit[]	Të gjithë pjesëmarrësit e tjerë, me detyrën e tyre.
topBilledIds	number[]	Id-të e personave që shfaqen të parët.
genres	string[]	Slug-et e zhanreve, siç i përcakton TheTVDB.
languages	string[]	Gjuhët për të cilat regjistrimi ka skedarë.
remoteIds	{ [site]: string }	Id-të në sajte të tjera (imdb, tmdb, wikidata, …), me çelës sipas sajtit.

Shembull

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

Pjesëmarrësit

Çdo element në cast dhe crew:

Fusha	Lloji	Përshkrimi
id	number	Id-ja e personit.
activityId	number	Id-ja e pjesëmarrjes, unike për çdo pjesëmarrje.
role	string	Personazhi i luajtur (aktorët).
job	string	Detyra (ekipi): director, writer, producer, …
slug	string	Slug-u i personit.
image	image	Fotoja e personit.
topBilled	boolean	Një pjesëmarrje e veçuar.
deleted	boolean	True nëse personi është hequr.

Skedarët e gjuhëve

Fusha	Lloji	Përshkrimi
type	string	Lloji i regjistrimit.
id	number	Id-ja në TheTVDB.
lang	string	Gjuha e këtij skedari.
name	string	Emri në këtë gjuhë.
overview	string	Përshkrimi në këtë gjuhë.
credits	{ [personId]: { name, role } }	Sipas id-së së personit: emri i tij në këtë gjuhë dhe roli i tij.

Shembull

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

Gjetja e një titulli sipas slug-ut

URL-të e serialeve dhe filmave përdorin slug (breaking-bad). Indeksi i slug-eve lidh çdo slug me id-në e tij dhe është ndarë në 256 skedarë të vegjël: skedari i një slug-u emërtohet sipas dy karaktereve të para heksadecimale të hash-it SHA-1 të slug-ut.

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