API

Egy film base.json fájlja tartalmazza a nyelvfüggetlen adatokat és a stáblistát; a nevek és leírások a nyelvi fájlokban vannak.

Fájlok

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

A kép egy objektum full és thumb elérési úttal.

base.json

Mező	Típus	Leírás
type	string	A rekord típusa.
id	number	TheTVDB-azonosító.
slug	string	URL-slug, a típuson belül egyedi.
popularity	number	TheTVDB népszerűségi pontszám; a magasabb népszerűbbet jelent. A pontszámok csak egy típuson belül hasonlíthatók össze.
deleted	boolean	True, ha a rekordot törölték. A fájljai elérhetők maradnak.
released	string	Megjelenés dátuma (YYYY-MM-DD).
runtime	number	Hossz percben.
image	image	Fő kép: címeknél plakát, személyeknél fotó.
images	{ [kind]: image }	Minden fajtából a legjobb kép: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Fajtánként a legjobb kép minden nyelven, a nyelvkóddal, mérettel és pontszámmal.
cast	credit[]	Színészek a stáblista sorrendjében.
crew	credit[]	Minden további közreműködő a munkakörével.
topBilledIds	number[]	Az elsőként kiemelendő személyek azonosítói.
genres	string[]	Műfaj-slugok a TheTVDB meghatározása szerint.
languages	string[]	Azok a nyelvek, amelyekhez a rekordnak van fájlja.
remoteIds	{ [site]: string }	Azonosítók más oldalakon (imdb, tmdb, wikidata, …), oldal szerint.

Példa

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

Stáblista

A cast és crew minden eleme:

Mező	Típus	Leírás
id	number	A személy azonosítója.
activityId	number	A közreműködés azonosítója, közreműködésenként egyedi.
role	string	Alakított szereplő (szereplők).
job	string	Munkakör (stáb): director, writer, producer, …
slug	string	A személy slugja.
image	image	A személy fotója.
topBilled	boolean	Kiemelt közreműködés.
deleted	boolean	True, ha a személyt törölték.

Nyelvi fájlok

Mező	Típus	Leírás
type	string	A rekord típusa.
id	number	TheTVDB-azonosító.
lang	string	A fájl nyelve.
name	string	Név ezen a nyelven.
overview	string	Leírás ezen a nyelven.
credits	{ [personId]: { name, role } }	Személyazonosítónként: a személy neve ezen a nyelven és a szerepe.

Példa

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

Cím keresése slug alapján

A sorozatok és filmek URL-jei slugokat használnak (breaking-bad). A slugindex minden slughoz hozzárendeli az azonosítóját, és 256 kis fájlra van felosztva: egy slug fájljának neve a slug SHA-1 értékének első két hexadecimális karaktere.

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