API

Bir filmin base.json dosyası dilden bağımsız verilerini ve katkıda bulunanlarını içerir; adları ve açıklamaları dil dosyalarındadır.

Dosyalar

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

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.
released	string	Çıkış 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.
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.
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": "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" }
}

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ü.

Örnek

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

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 = "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())