API

Plik base.json filmu zawiera dane niezależne od języka i twórców; nazwy i opisy są w plikach językowych.

Pliki

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

Obraz to obiekt ze ścieżkami full i thumb.

base.json

Pole	Typ	Opis
type	string	Typ rekordu.
id	number	Id z TheTVDB.
slug	string	Slug URL, unikalny w obrębie typu.
popularity	number	Wynik popularności z TheTVDB; wyższy oznacza popularniejszy. Wyniki można porównywać tylko w obrębie jednego typu.
deleted	boolean	True, jeśli rekord został usunięty. Jego pliki pozostają opublikowane.
released	string	Data premiery (YYYY-MM-DD).
runtime	number	Długość w minutach.
image	image	Główny obraz: plakat dla tytułów, zdjęcie dla osób.
images	{ [kind]: image }	Najlepszy obraz każdego rodzaju: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Dla każdego rodzaju najlepszy obraz w każdym języku, z kodem języka, rozmiarem i wynikiem.
cast	credit[]	Aktorzy w kolejności z napisów.
crew	credit[]	Wszyscy pozostali twórcy wraz z funkcją.
topBilledIds	number[]	Id osób, które mają być wyróżnione na początku.
genres	string[]	Slugi gatunków zgodnie z definicją TheTVDB.
languages	string[]	Języki, dla których ten rekord ma pliki.
remoteIds	{ [site]: string }	Id w innych serwisach (imdb, tmdb, wikidata, …), według serwisu.

Przykład

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

Twórcy

Każdy wpis w cast i crew:

Pole	Typ	Opis
id	number	Id osoby.
activityId	number	Id udziału, unikalne dla każdego udziału.
role	string	Odgrywana postać (obsada).
job	string	Funkcja (ekipa): director, writer, producer, …
slug	string	Slug osoby.
image	image	Zdjęcie osoby.
topBilled	boolean	Wyróżniony udział.
deleted	boolean	True, jeśli osoba została usunięta.

Pliki językowe

Pole	Typ	Opis
type	string	Typ rekordu.
id	number	Id z TheTVDB.
lang	string	Język tego pliku.
name	string	Nazwa w tym języku.
overview	string	Opis w tym języku.
credits	{ [personId]: { name, role } }	Według id osoby: jej imię i nazwisko w tym języku oraz rola.

Przykład

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

Wyszukiwanie tytułu po slugu

Adresy URL seriali i filmów używają slugów (breaking-bad). Indeks slugów mapuje każdy slug na jego id i jest podzielony na 256 małych plików: plik danego slugu nosi nazwę od dwóch pierwszych znaków szesnastkowych 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())