Alternativa k API TheTVDB

Který se hodí pro projekt o seriálech

TheTVDB se zaměřuje na seriály a drží několik řazení epizod seriálu, včetně vysílacího, podle DVD a absolutního, za modelem klíče API. Než naplánujete komerční produkt, ověřte si v jejich dokumentaci licencování. Zvolte amodb, když chcete seriály, filmy a osoby z jednoho klíče, cesty TMDB v3 a 14 jazyků. Zvolte TheTVDB, když je přesné alternativní číslování středem vaší aplikace, protože amodb skupiny epizod seriálu vypisuje, ale neposkytuje, co je uvnitř nich.

Jak se data seriálů mapují mezi oběma

Pojmy si odpovídají, ale názvy se liší. Tato tabulka pokrývá, co aplikace o seriálech obvykle čte.

Pole epizod používají názvy TMDB: air_date, episode_number, season_number, runtime a still_path. external_ids sezón a epizod jsou všechna null, ID z TVDB jedné sezóny nebo epizody proto z amodb přečíst nelze. Spojujte místo toho přes season_number a episode_number. Podrobnosti jsou na stránce sezóny a epizody.

Co vrací seznam skupin epizod

Volání seznamu ukazuje, která řazení pro seriál existují. Epizody uvnitř nich nevrací.

Toto je skutečná odpověď pro Breaking Bad.

{
  "id": 1396,
  "results": [
    {
      "description": "Seasons grouped as they appear on DVD, as well as paid video-on-demand services, such as Prime Video and YouTube.",
      "episode_count": 62,
      "group_count": 6,
      "id": "69f50757054263b7bc87e32a",
      "name": "DVD / PVOD",
      "network": null,
      "type": 3
    }
  ]
}

Některé seriály vracejí jedno vysílací řazení a jiné několik a některé vracejí prázdné pole results. Vyzkoušejte seriály, na kterých vám záleží. Protože se obsah skupiny nenabízí, aplikace, která potřebuje číslo každé epizody podle DVD nebo absolutní, ho z amodb nezíská.

Srovnání funkcí

V čem se amodb liší

• Jeden klíč pro celý katalog. Seriál, jeho obsazení, trailery a film, který sdílí herce, používají stejnou základní URL a stejný limit.
• Hodnocení vedle průvodce epizodami. append_to_response=ratings v detailech seriálu přidá IMDb a další skóre jedním voláním.
• Prosté hlavičky pro tempo. X-RateLimit-Remaining a X-RateLimit-Reset řeknou synchronizační úloze, kolik požadavků zbývá v okně 60 sekund.
• Zachované původní názvy. Seriál si ponechává original_name, zatímco name se řídí vaším language, což pomáhá, když zobrazujete původní titul.

Kdy se TheTVDB hodí lépe

• Řazení je produkt. Pokud se vaši uživatelé přou o řazení podle DVD, vysílání a absolutní, TheTVDB to bere jako jádro svého modelu. amodb řazení seriálu pojmenuje, ale jejich epizody nevrací a které skupiny existují, se liší podle seriálu.
• Stávající integrace. Pokud váš pipeline už ukládá ID z TheTVDB a čte jeho řazení, ponechte tuto část a amodb přidejte pro další data.
• Zaměření na seriály. Pokud nikdy nezobrazujete filmy ani osoby, zdroj postavený kolem seriálů má méně k naučení.

Přechod na amodb

ID z TVDB, která ukládáte, namapujte jednou. Poté používejte ID amodb pro každé volání. Endpoint find převádí jen ID seriálů. Jeho pole tv_season_results a tv_episode_results jsou vždy prázdná, sezóny a epizody proto mapujte podle čísla.

const key = process.env.AMODB_KEY;
const headers = { Authorization: `Bearer ${key}` };
const base = 'https://api.amodb.dev/3';

async function getJson(path) {
  const res = await fetch(`${base}${path}`, { headers });
  if (!res.ok) throw new Error(`${path} returned ${res.status}`);
  return res.json();
}

const found = await getJson('/find/81189?external_source=tvdb_id');
const show = found.tv_results[0];
console.log(show.id, show.name);

const groups = await getJson(`/tv/${show.id}/episode_groups`);
for (const g of groups.results) {
  console.log(g.name, g.type, g.episode_count);
}

První požadavek vrátí Breaking Bad s ID 1396. Druhý vypíše řazení, která pro tento seriál existují, s jejich velikostmi. Chcete-li porovnat číslování s tím, co ukládáte nyní, přečtěte vysílací pořadí z /tv/{id}/season/{n} a případné alternativní pořadí ponechte na straně TheTVDB. Tuto kontrolu proveďte u deseti nejsledovanějších seriálů, než přesunete zbytek.

Každé volání se počítá jako jeden požadavek v okně 60 sekund a 429 nese Retry-After. Viz hledání podle externího ID a limity požadavků.

Ceník

amodb je předplacené bez automatického obnovení. Zvolte 1, 3, 6, 12 nebo 24 měsíců a jeden ze tří tarifů s 20, 40 nebo 120 požadavky za minutu. Delší období mají slevu 10, 20, 30 nebo 40 procent a každý tarif dostane všechna data. Bezplatný tarif neexistuje. Částky jsou na stránce ceník.