API

Soubor base.json seriálu obsahuje všechny jeho řady a díly, takže jeden požadavek získá celý seriál. Názvy a popisy seriálu, řad a dílů jsou v jazykových souborech.

Soubory

https://api.watchittrackit.com/v1/tv/{id}/base.json
https://api.watchittrackit.com/v1/tv/{id}/{lang}.json
https://api.watchittrackit.com/v1/tv/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é.
firstAired	string	Datum prvního dílu (YYYY-MM-DD).
lastAired	string	Datum posledního dílu.
status	string	Stav vysílání z TheTVDB, například Continuing nebo Ended.
network	string	Televizní stanice.
originalLanguage	string	Kód původního jazyka.
originalCountry	string	Země původu (třípísmenný kód).
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í.
seasons	season[]	Řady v pořadí vysílání, každá s vlastními díly.
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": "tv",
  "id": 81189,
  "slug": "breaking-bad",
  "popularity": 3287090,
  "deleted": false,
  "firstAired": "2008-01-20",
  "lastAired": "2013-09-29",
  "status": "Ended",
  "images": {
    "poster": { "full": "/images/tv/81189/1340353429.jpg", "thumb": "/images/tv/81189/1340353429.t.jpg" }
  },
  "cast": [
    { "id": 255211, "activityId": 180, "role": "Walter White", "slug": "bryan-cranston", "topBilled": false, "deleted": false }
  ],
  "seasons": [
    {
      "id": 30272, "number": 1, "deleted": false,
      "episodes": [{ "id": 349232, "number": 1, "aired": "2008-01-20", "runtime": 58, "deleted": false }]
    }
  ],
  "genres": ["drama", "crime"],
  "languages": ["de", "en", "fr"],
  "remoteIds": { "imdb": "tt0903747" }
}

Řady

Pole	Typ	Popis
id	number	Id z TheTVDB.
number	number	Číslo řady; 0 jsou speciály.
deleted	boolean	True, pokud byl záznam odstraněn. Jeho soubory zůstávají zveřejněné.
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.
episodes	episode[]	Díly řady.

Díly

Pole	Typ	Popis
id	number	Id z TheTVDB.
number	number	Číslo dílu v rámci řady.
aired	string	Datum vysílání (YYYY-MM-DD).
runtime	number	Délka v minutách.
image	image	Hlavní obrázek: plakát u titulů, fotka u lidí.
criticalToStory	boolean	Označeno jako zásadní pro děj.
specialType	string	Druh speciálu (díly řady 0).
deleted	boolean	True, pokud byl záznam odstraněn. Jeho soubory zůstávají zveřejněné.

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.
seasons	{ [seasonId]: { name, overview } }	Podle id řady: její název a popis.
episodes	{ [episodeId]: { name, overview } }	Podle id dílu: jeho název a popis.

Příklad

{
  "type": "tv",
  "id": 81189,
  "lang": "en",
  "name": "Breaking Bad",
  "overview": "When Walter White, a chemistry teacher, …",
  "credits": { "255211": { "name": "Bryan Cranston", "role": "Walter White" } },
  "seasons": { "30272": { "overview": "High school chemistry teacher Walter White…" } },
  "episodes": { "349232": { "name": "Pilot", "overview": "When an unassuming high school chemistry teacher…" } }
}

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 = "breaking-bad"
const shard = createHash("sha1").update(slug, "utf8").digest("hex").slice(0, 2)
const index = await fetch(`https://api.watchittrackit.com/v1/tv/slugs/${shard}.json`).then((r) => r.json())
const id = index[slug]
const record = await fetch(`https://api.watchittrackit.com/v1/tv/${id}/base.json`).then((r) => r.json())