API

Soubor base.json filmu obsahuje data nezávislá na jazyce a tvůrce; názvy a popisy jsou v jazykových souborech.

Soubory

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

Obrázek je objekt s cestami full a thumb.

base.json

Pole	Typ	Popis
type	string	Typ záznamu.
id	number	Id z TheTVDB.
slug	string	Slug pro URL, jedinečný v rámci typu.
popularity	number	Skóre popularity z TheTVDB; vyšší znamená populárnější. Skóre lze porovnávat jen v rámci jednoho typu.
deleted	boolean	True, pokud byl záznam odstraněn. Jeho soubory zůstávají zveřejněné.
released	string	Datum vydání (YYYY-MM-DD).
runtime	number	Délka v minutách.
image	image	Hlavní obrázek: plakát u titulů, fotka u lidí.
images	{ [kind]: image }	Nejlepší obrázek každého druhu: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Pro každý druh nejlepší obrázek v každém jazyce, s kódem jazyka, velikostí a skóre.
cast	credit[]	Herci v pořadí titulků.
crew	credit[]	Všichni ostatní uvedení tvůrci s jejich funkcí.
topBilledIds	number[]	Id lidí, kteří se mají zobrazit jako první.
genres	string[]	Slugy žánrů podle definice TheTVDB.
languages	string[]	Jazyky, pro které má tento záznam soubory.
remoteIds	{ [site]: string }	Id na jiných webech (imdb, tmdb, wikidata, …), podle webu.

Příklad

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

Tvůrci

Každá položka v cast a crew:

Pole	Typ	Popis
id	number	Id osoby.
activityId	number	Id zásluhy, jedinečné pro každou zásluhu.
role	string	Ztvárněná postava (herci).
job	string	Funkce (štáb): director, writer, producer, …
slug	string	Slug osoby.
image	image	Fotka osoby.
topBilled	boolean	Zvýrazněná zásluha.
deleted	boolean	True, pokud byla osoba odstraněna.

Jazykové soubory

Pole	Typ	Popis
type	string	Typ záznamu.
id	number	Id z TheTVDB.
lang	string	Jazyk tohoto souboru.
name	string	Název v tomto jazyce.
overview	string	Popis v tomto jazyce.
credits	{ [personId]: { name, role } }	Podle id osoby: její jméno v tomto jazyce a její role.

Příklad

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

Vyhledání titulu podle slugu

Adresy URL seriálů a filmů používají slugy (breaking-bad). Index slugů přiřazuje každému slugu jeho id a je rozdělen do 256 malých souborů: soubor slugu je pojmenován podle prvních dvou hexadecimálních znaků SHA-1 slugu.

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