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 id.
slug	string	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[]	먼저 소개할 인물의 id.
genres	string[]	TheTVDB가 정의한 장르 슬러그.
languages	string[]	이 레코드에 파일이 있는 언어.
remoteIds	{ [site]: string }	다른 사이트(imdb, tmdb, wikidata, …)의 id. 사이트 이름을 키로 합니다.

예시

{
  "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	인물 id.
activityId	number	크레딧 id. 크레딧마다 고유합니다.
role	string	맡은 배역(출연진).
job	string	직무(제작진): director, writer, producer, …
slug	string	인물의 슬러그.
image	image	인물의 사진.
topBilled	boolean	주요 크레딧.
deleted	boolean	인물이 삭제되었으면 true입니다.

언어 파일

필드	유형	설명
type	string	레코드 유형.
id	number	TheTVDB id.
lang	string	이 파일의 언어.
name	string	이 언어로 된 이름.
overview	string	이 언어로 된 설명.
credits	{ [personId]: { name, role } }	인물 id별: 이 언어로 된 이름과 배역.

예시

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

슬러그로 작품 찾기

시리즈와 영화 URL은 슬러그(breaking-bad)를 사용합니다. 슬러그 색인은 각 슬러그를 id에 대응시키며, 256개의 작은 파일로 나뉘어 있습니다. 슬러그가 속한 파일의 이름은 슬러그 SHA-1 값의 앞 두 자리 16진수 문자입니다.

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