API

Elokuvan base.json sisältää sen kielestä riippumattomat tiedot ja tekijät; nimet ja kuvaukset ovat kielitiedostoissa.

Tiedostot

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

Kuva on objekti, jossa on polut full ja thumb.

base.json

Kenttä	Tyyppi	Kuvaus
type	string	Tietueen tyyppi.
id	number	TheTVDB-tunniste.
slug	string	URL-slug, yksilöllinen tyypin sisällä.
popularity	number	TheTVDB:n suosiopisteet; suurempi arvo tarkoittaa suositumpaa. Pisteet ovat vertailukelpoisia vain saman tyypin sisällä.
deleted	boolean	Tosi, jos tietue on poistettu. Sen tiedostot pysyvät julkaistuina.
released	string	Julkaisupäivä (YYYY-MM-DD).
runtime	number	Kesto minuutteina.
image	image	Pääkuva: juliste nimikkeille, valokuva henkilöille.
images	{ [kind]: image }	Paras kuva kustakin lajista: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Kustakin lajista paras kuva kullakin kielellä, kielikoodin, koon ja pisteiden kera.
cast	credit[]	Näyttelijät tekijäluettelon järjestyksessä.
crew	credit[]	Kaikki muut tekijät tehtävineen.
topBilledIds	number[]	Ensimmäisinä nostettavien henkilöiden tunnisteet.
genres	string[]	Lajityyppien slugit TheTVDB:n määritelmien mukaisesti.
languages	string[]	Kielet, joille tietueella on tiedostot.
remoteIds	{ [site]: string }	Tunnisteet muilla sivustoilla (imdb, tmdb, wikidata, …), avaimena sivusto.

Esimerkki

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

Tekijät

Jokainen cast- ja crew-luettelon merkintä:

Kenttä	Tyyppi	Kuvaus
id	number	Henkilön tunniste.
activityId	number	Tekijämerkinnän tunniste, yksilöllinen merkintää kohden.
role	string	Esitetty hahmo (näyttelijät).
job	string	Tehtävä (työryhmä): director, writer, producer, …
slug	string	Henkilön slug.
image	image	Henkilön valokuva.
topBilled	boolean	Nostettu tekijämerkintä.
deleted	boolean	Tosi, jos henkilö on poistettu.

Kielitiedostot

Kenttä	Tyyppi	Kuvaus
type	string	Tietueen tyyppi.
id	number	TheTVDB-tunniste.
lang	string	Tämän tiedoston kieli.
name	string	Nimi tällä kielellä.
overview	string	Kuvaus tällä kielellä.
credits	{ [personId]: { name, role } }	Henkilötunnisteittain: henkilön nimi tällä kielellä ja rooli.

Esimerkki

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

Nimikkeen löytäminen slugin perusteella

Sarjojen ja elokuvien URL-osoitteet käyttävät slugeja (breaking-bad). Slug-hakemisto yhdistää jokaisen slugin sen tunnisteeseen, ja se on jaettu 256 pieneen tiedostoon: slugin tiedosto on nimetty slugin SHA-1-tiivisteen kahden ensimmäisen heksadesimaalimerkin mukaan.

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