API

فایل base.json یک فیلم داده‌های مستقل از زبان و عوامل آن را در بر دارد؛ نام‌ها و توضیحاتش در فایل‌های زبان هستند.

فایل‌ها

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

هر تصویر یک شیء با مسیرهای full و thumb است.

base.json

فیلد	نوع	توضیح
type	string	نوع رکورد.
id	number	شناسه TheTVDB.
slug	string	slug نشانی URL، یکتا در هر نوع.
popularity	number	امتیاز محبوبیت TheTVDB؛ امتیاز بالاتر یعنی محبوب‌تر. امتیازها فقط در یک نوع قابل مقایسه‌اند.
deleted	boolean	اگر رکورد حذف شده باشد true است. فایل‌هایش همچنان منتشر می‌مانند.
released	string	تاریخ اکران (YYYY-MM-DD).
runtime	number	مدت به دقیقه.
image	image	تصویر اصلی: پوستر برای آثار، عکس برای افراد.
images	{ [kind]: image }	بهترین تصویر از هر نوع: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	برای هر نوع، بهترین تصویر در هر زبان، همراه با کد زبان، اندازه و امتیاز آن.
cast	credit[]	بازیگران، به ترتیب تیتراژ.
crew	credit[]	سایر افراد دارای اعتبار، همراه با سمتشان.
topBilledIds	number[]	شناسه افرادی که باید اول نمایش داده شوند.
genres	string[]	slugهای ژانر، مطابق تعریف TheTVDB.
languages	string[]	زبان‌هایی که این رکورد برایشان فایل دارد.
remoteIds	{ [site]: string }	شناسه‌ها در سایت‌های دیگر (imdb, tmdb, wikidata, …)، به تفکیک سایت.

نمونه

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

عوامل

هر مورد در cast و crew:

فیلد	نوع	توضیح
id	number	شناسه فرد.
activityId	number	شناسه اعتبار، یکتا برای هر اعتبار.
role	string	نقش ایفاشده (بازیگران).
job	string	سمت (عوامل پشت صحنه): director, writer, producer, …
slug	string	slug فرد.
image	image	عکس فرد.
topBilled	boolean	اعتبار برجسته.
deleted	boolean	اگر فرد حذف شده باشد true است.

فایل‌های زبان

فیلد	نوع	توضیح
type	string	نوع رکورد.
id	number	شناسه TheTVDB.
lang	string	زبان این فایل.
name	string	نام به این زبان.
overview	string	توضیح به این زبان.
credits	{ [personId]: { name, role } }	برای هر شناسه فرد: نام او به این زبان و نقشش.

نمونه

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

یافتن یک اثر با slug آن

نشانی‌های URL سریال‌ها و فیلم‌ها از slug استفاده می‌کنند (breaking-bad). فهرست slug هر slug را به شناسه‌اش نگاشت می‌کند و به 256 فایل کوچک تقسیم شده است: نام فایل هر slug دو نویسه اول هگزادسیمال SHA-1 آن slug است.

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