API

Le base.json d'un film contient ses données indépendantes de la langue et son générique ; ses noms et descriptions se trouvent dans les fichiers de langue.

Fichiers

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

Une image est un objet avec les chemins full et thumb.

base.json

Champ	Type	Description
type	string	Type d'enregistrement.
id	number	Identifiant TheTVDB.
slug	string	Slug d'URL, unique au sein du type.
popularity	number	Score de popularité TheTVDB ; plus il est élevé, plus le titre est populaire. Les scores ne sont comparables qu'au sein d'un même type.
deleted	boolean	True si l'enregistrement a été supprimé. Ses fichiers restent publiés.
released	string	Date de sortie (YYYY-MM-DD).
runtime	number	Durée en minutes.
image	image	Image principale : une affiche pour les titres, une photo pour les personnes.
images	{ [kind]: image }	La meilleure image de chaque sorte : poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Pour chaque sorte, la meilleure image dans chaque langue, avec son code de langue, sa taille et son score.
cast	credit[]	Acteurs, dans l'ordre du générique.
crew	credit[]	Toutes les autres personnes créditées, avec leur fonction.
topBilledIds	number[]	Identifiants des personnes à mettre en avant en premier.
genres	string[]	Slugs de genres, tels que définis par TheTVDB.
languages	string[]	Langues pour lesquelles cet enregistrement possède des fichiers.
remoteIds	{ [site]: string }	Identifiants sur d'autres sites (imdb, tmdb, wikidata, …), indexés par site.

Exemple

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

Générique

Chaque entrée de cast et crew :

Champ	Type	Description
id	number	Identifiant de la personne.
activityId	number	Identifiant du crédit, unique pour chaque crédit.
role	string	Personnage interprété (distribution).
job	string	Fonction (équipe) : director, writer, producer, …
slug	string	Le slug de la personne.
image	image	La photo de la personne.
topBilled	boolean	Un crédit mis en avant.
deleted	boolean	True si la personne a été supprimée.

Fichiers de langue

Champ	Type	Description
type	string	Type d'enregistrement.
id	number	Identifiant TheTVDB.
lang	string	Langue de ce fichier.
name	string	Nom dans cette langue.
overview	string	Description dans cette langue.
credits	{ [personId]: { name, role } }	Par identifiant de personne : son nom dans cette langue et son rôle.

Exemple

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

Trouver un titre par son slug

Les URL des séries et des films utilisent des slugs (breaking-bad). L'index des slugs associe chaque slug à son identifiant et est réparti en 256 petits fichiers : le fichier d'un slug porte le nom des deux premiers caractères hexadécimaux du SHA-1 du 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())