API

En films base.json inneholder de språkuavhengige dataene og de medvirkende; navn og beskrivelser ligger i språkfilene.

Filer

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

Et bilde er et objekt med stiene full og thumb.

base.json

Felt	Type	Beskrivelse
type	string	Posttype.
id	number	TheTVDB-id.
slug	string	URL-slug, unik innenfor typen.
popularity	number	Popularitetspoeng fra TheTVDB; høyere betyr mer populær. Poengene kan bare sammenlignes innenfor samme type.
deleted	boolean	Sann hvis posten er fjernet. Filene forblir publisert.
released	string	Premieredato (YYYY-MM-DD).
runtime	number	Lengde i minutter.
image	image	Hovedbilde: en plakat for titler, et foto for personer.
images	{ [kind]: image }	Det beste bildet av hver sort: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	For hver sort, det beste bildet på hvert språk, med språkkode, størrelse og poeng.
cast	credit[]	Skuespillere, i krediteringsrekkefølge.
crew	credit[]	Alle andre som er kreditert, med oppgaven sin.
topBilledIds	number[]	Id-er for personer som skal fremheves først.
genres	string[]	Sjanger-slugs, slik TheTVDB definerer dem.
languages	string[]	Språk posten har filer for.
remoteIds	{ [site]: string }	Id-er på andre nettsteder (imdb, tmdb, wikidata, …), med nettstedet som nøkkel.

Eksempel

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

Medvirkende

Hver oppføring i cast og crew:

Felt	Type	Beskrivelse
id	number	Personens id.
activityId	number	Id for kreditten, unik per kreditt.
role	string	Rollefigur (skuespillere).
job	string	Oppgave (stab): director, writer, producer, …
slug	string	Personens slug.
image	image	Personens foto.
topBilled	boolean	En fremhevet kreditt.
deleted	boolean	Sann hvis personen er fjernet.

Språkfiler

Felt	Type	Beskrivelse
type	string	Posttype.
id	number	TheTVDB-id.
lang	string	Språket til denne filen.
name	string	Navn på dette språket.
overview	string	Beskrivelse på dette språket.
credits	{ [personId]: { name, role } }	Per person-id: navnet på dette språket og rollen.

Eksempel

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

Finne en tittel via slug

URL-er for serier og filmer bruker slugs (breaking-bad). Slug-indeksen kobler hver slug til id-en sin og er delt opp i 256 små filer: filen for en slug er oppkalt etter de to første heksadesimale tegnene i SHA-1 av slugen.

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