API

Bir dizinin base.json dosyası tüm sezonlarını ve bölümlerini içerir, böylece tek bir istekle dizinin tamamı alınır. Dizinin, sezonlarının ve bölümlerinin adları ve açıklamaları dil dosyalarındadır.

Dosyalar

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

Görsel, full ve thumb yollarına sahip bir nesnedir.

base.json

Alan	Tür	Açıklama
type	string	Kayıt türü.
id	number	TheTVDB kimliği.
slug	string	URL slug'ı, tür içinde benzersiz.
popularity	number	TheTVDB popülerlik puanı; yüksek olan daha popülerdir. Puanlar yalnızca aynı tür içinde karşılaştırılabilir.
deleted	boolean	Kayıt kaldırıldıysa true. Dosyaları yayımlanmaya devam eder.
firstAired	string	İlk bölümün tarihi (YYYY-MM-DD).
lastAired	string	En son bölümün tarihi.
status	string	TheTVDB'deki yayın durumu, örneğin Continuing veya Ended.
network	string	Kanal.
originalLanguage	string	Orijinal dil kodu.
originalCountry	string	Orijinal ülke (üç harfli kod).
image	image	Ana görsel: yapımlar için afiş, kişiler için fotoğraf.
images	{ [kind]: image }	Her türün en iyi görseli: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Tür başına, her dildeki en iyi görsel; dil kodu, boyutu ve puanıyla birlikte.
cast	credit[]	Jenerik sırasına göre oyuncular.
crew	credit[]	Görevleriyle birlikte diğer tüm katkıda bulunanlar.
topBilledIds	number[]	Önce gösterilecek kişilerin kimlikleri.
seasons	season[]	Yayın sırasına göre sezonlar, her biri bölümleriyle birlikte.
genres	string[]	TheTVDB'nin tanımladığı şekliyle tür slug'ları.
languages	string[]	Bu kaydın dosyası bulunan diller.
remoteIds	{ [site]: string }	Diğer sitelerdeki kimlikler (imdb, tmdb, wikidata, …), siteye göre anahtarlanmış.

Örnek

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

Sezonlar

Alan	Tür	Açıklama
id	number	TheTVDB kimliği.
number	number	Sezon numarası; 0 özel bölümlerdir.
deleted	boolean	Kayıt kaldırıldıysa true. Dosyaları yayımlanmaya devam eder.
image	image	Ana görsel: yapımlar için afiş, kişiler için fotoğraf.
images	{ [kind]: image }	Her türün en iyi görseli: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Tür başına, her dildeki en iyi görsel; dil kodu, boyutu ve puanıyla birlikte.
episodes	episode[]	Sezonun bölümleri.

Bölümler

Alan	Tür	Açıklama
id	number	TheTVDB kimliği.
number	number	Sezon içindeki bölüm numarası.
aired	string	Yayın tarihi (YYYY-MM-DD).
runtime	number	Dakika cinsinden süre.
image	image	Ana görsel: yapımlar için afiş, kişiler için fotoğraf.
criticalToStory	boolean	Hikâye için önemli olarak işaretlenmiş.
specialType	string	Özel bölümün türü (0. sezon bölümleri).
deleted	boolean	Kayıt kaldırıldıysa true. Dosyaları yayımlanmaya devam eder.

Katkıda bulunanlar

cast ve crew içindeki her öğe:

Alan	Tür	Açıklama
id	number	Kişi kimliği.
activityId	number	Katkı kimliği, her katkı için benzersiz.
role	string	Canlandırılan karakter (oyuncular).
job	string	Görev (ekip): director, writer, producer, …
slug	string	Kişinin slug'ı.
image	image	Kişinin fotoğrafı.
topBilled	boolean	Öne çıkan bir katkı.
deleted	boolean	Kişi kaldırıldıysa true.

Dil dosyaları

Alan	Tür	Açıklama
type	string	Kayıt türü.
id	number	TheTVDB kimliği.
lang	string	Bu dosyanın dili.
name	string	Bu dildeki ad.
overview	string	Bu dildeki açıklama.
credits	{ [personId]: { name, role } }	Kişi kimliğine göre: kişinin bu dildeki adı ve rolü.
seasons	{ [seasonId]: { name, overview } }	Sezon kimliğine göre: sezonun adı ve açıklaması.
episodes	{ [episodeId]: { name, overview } }	Bölüm kimliğine göre: bölümün adı ve açıklaması.

Örnek

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

Bir yapımı slug'ıyla bulma

Dizi ve film URL'leri slug kullanır (breaking-bad). Slug dizini her slug'ı kimliğiyle eşler ve 256 küçük dosyaya bölünmüştür: bir slug'ın dosyası, slug'ın SHA-1 değerinin ilk iki onaltılık karakteriyle adlandırılır.

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