API

يحتوي ملف base.json الخاص بالمسلسل على جميع مواسمه وحلقاته، فيكفي طلب واحد للحصول على المسلسل كاملًا. أسماء المسلسل ومواسمه وحلقاته وأوصافها موجودة في ملفات اللغات.

الملفات

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

الصورة كائن يحتوي على المسارين full وthumb.

base.json

الحقل	النوع	الوصف
type	string	نوع السجل.
id	number	المعرّف في TheTVDB.
slug	string	المعرّف النصي في عنوان URL، فريد ضمن النوع.
popularity	number	درجة الشعبية في TheTVDB؛ كلما ارتفعت زادت الشعبية. لا تصلح المقارنة بين الدرجات إلا ضمن النوع نفسه.
deleted	boolean	true إذا حُذف السجل. تبقى ملفاته منشورة.
firstAired	string	تاريخ أول حلقة (YYYY-MM-DD).
lastAired	string	تاريخ أحدث حلقة.
status	string	حالة العرض من TheTVDB، مثل Continuing or Ended.
network	string	الشبكة.
originalLanguage	string	رمز اللغة الأصلية.
originalCountry	string	البلد الأصلي (رمز من ثلاثة أحرف).
image	image	الصورة الرئيسية: ملصق للأعمال، وصورة شخصية للأشخاص.
images	{ [kind]: image }	أفضل صورة من كل نوع: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	لكل نوع، أفضل صورة في كل لغة، مع رمز لغتها وحجمها ودرجتها.
cast	credit[]	الممثلون، بترتيب ظهور أسمائهم.
crew	credit[]	كل المشاركين الآخرين، مع وظائفهم.
topBilledIds	number[]	معرّفات الأشخاص الذين يُعرضون أولًا.
seasons	season[]	المواسم بترتيب عرضها، وكل موسم مع حلقاته.
genres	string[]	المعرّفات النصية للتصنيفات كما يعرّفها TheTVDB.
languages	string[]	اللغات التي لهذا السجل ملفات بها.
remoteIds	{ [site]: string }	المعرّفات في مواقع أخرى (imdb, tmdb, wikidata, …)، مفهرسة حسب الموقع.

مثال

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

المواسم

الحقل	النوع	الوصف
id	number	المعرّف في TheTVDB.
number	number	رقم الموسم؛ 0 للحلقات الخاصة.
deleted	boolean	true إذا حُذف السجل. تبقى ملفاته منشورة.
image	image	الصورة الرئيسية: ملصق للأعمال، وصورة شخصية للأشخاص.
images	{ [kind]: image }	أفضل صورة من كل نوع: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	لكل نوع، أفضل صورة في كل لغة، مع رمز لغتها وحجمها ودرجتها.
episodes	episode[]	حلقات الموسم.

الحلقات

الحقل	النوع	الوصف
id	number	المعرّف في TheTVDB.
number	number	رقم الحلقة ضمن موسمها.
aired	string	تاريخ العرض (YYYY-MM-DD).
runtime	number	المدة بالدقائق.
image	image	الصورة الرئيسية: ملصق للأعمال، وصورة شخصية للأشخاص.
criticalToStory	boolean	مُعلَّمة بأنها أساسية للقصة.
specialType	string	نوع الحلقة الخاصة (حلقات الموسم 0).
deleted	boolean	true إذا حُذف السجل. تبقى ملفاته منشورة.

طاقم العمل

كل عنصر في cast وcrew:

الحقل	النوع	الوصف
id	number	معرّف الشخص.
activityId	number	معرّف المشاركة، فريد لكل مشاركة.
role	string	الشخصية المؤدّاة (الممثلون).
job	string	الوظيفة (الطاقم الفني): director, writer, producer, …
slug	string	المعرّف النصي للشخص.
image	image	صورة الشخص.
topBilled	boolean	مشاركة بارزة.
deleted	boolean	true إذا حُذف الشخص.

ملفات اللغات

الحقل	النوع	الوصف
type	string	نوع السجل.
id	number	المعرّف في TheTVDB.
lang	string	لغة هذا الملف.
name	string	الاسم بهذه اللغة.
overview	string	الوصف بهذه اللغة.
credits	{ [personId]: { name, role } }	لكل معرّف شخص: اسمه بهذه اللغة ودوره.
seasons	{ [seasonId]: { name, overview } }	لكل معرّف موسم: اسمه ووصفه.
episodes	{ [episodeId]: { name, overview } }	لكل معرّف حلقة: اسمها ووصفها.

مثال

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

العثور على عمل عبر معرّفه النصي

تستخدم عناوين URL للمسلسلات والأفلام معرّفات نصية (breaking-bad). يربط فهرس المعرّفات النصية كل معرّف نصي بمعرّفه الرقمي، وهو مقسّم إلى 256 ملفًا صغيرًا: يُسمّى ملف المعرّف النصي بأول حرفين ست عشريين من قيمة SHA-1 للمعرّف النصي.

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