Алтернатива на TheTVDB API

Кое пасва на проект за сериали

TheTVDB е насочен към сериали и пази за сериала няколко подредби на епизодите, включително излъчена, DVD и абсолютна, по модел с API ключ. Вижте документацията им за лицензирането, преди да планирате търговски продукт. Изберете amodb, когато искате сериали, филми и личности с един ключ, пътища на TMDB v3 и 14 езика. Изберете TheTVDB, когато точната алтернативна номерация е центърът на приложението ви, защото amodb изброява групите епизоди на сериал, но не обслужва какво има в тях.

Как данните за сериали се съпоставят между двете

Понятията си съответстват, но имената се различават. Тази таблица покрива това, което приложение за сериали обикновено чете.

Полетата на епизода ползват имената на TMDB: air_date, episode_number, season_number, runtime и still_path. external_ids на сезон и епизод са все null, така че id от TVDB на отделен сезон или епизод не може да се прочете от amodb. Свързвайте по season_number и episode_number. Подробности има на страницата сезони и епизоди.

Какво връща списъкът с групи епизоди

Извикването за списъка показва кои подредби съществуват за сериал. Не връща епизодите в тях.

Това е истински отговор за 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
    }
  ]
}

Някои сериали връщат една излъчена подредба, други няколко, а трети връщат празен масив results. Тествайте сериалите, които ви интересуват. Тъй като съдържанието на групата не се предлага, приложение, което има нужда от DVD или абсолютния номер на всеки епизод, не може да го вземе от amodb.

Сравнение на функциите

С какво се различава amodb

• Един ключ за целия каталог. Сериал, актьорите му, трейлърите му и филм, който споделя актьор, ползват един и същ базов URL и един и същ лимит.
• Рейтинги до справочника по епизоди. append_to_response=ratings към детайлите на сериал добавя оценки от IMDb и други с едно извикване.
• Обикновени заглавки за регулиране на темпото. X-RateLimit-Remaining и X-RateLimit-Reset казват на задача за синхронизация колко заявки остават в 60-секундния прозорец.
• Оригиналните имена се пазят. Сериалът запазва original_name, докато name следва вашия language, което помага, когато показвате родно заглавие.

Къде TheTVDB пасва по-добре

• Подредбата е продуктът. Ако потребителите ви спорят за DVD срещу излъчена срещу абсолютна подредба, TheTVDB третира това като основна част от модела си. amodb назовава подредбите на сериал, но не връща епизодите им, а кои групи съществуват зависи от сериала.
• Съществуващи интеграции. Ако конвейерът ви вече пази id от TheTVDB и чете подредбите му, запазете тази част и добавете amodb за допълнителните данни.
• Фокус върху сериали. Ако никога не показвате филми или личности, източник, изграден около сериали, има по-малко за научаване.

Миграция към amodb

Съпоставете запазените си id от TVDB веднъж. След това ползвайте id на amodb за всяко извикване. Ендпойнтът find разрешава само id на сериали. Масивите му tv_season_results и tv_episode_results винаги са празни, затова съпоставяйте сезоните и епизодите по номер.

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);
}

Първата заявка връща Breaking Bad с id 1396. Втората изброява подредбите, които съществуват за този сериал, с размерите им. За да сравните номерацията с това, което пазите сега, четете излъчената подредба от /tv/{id}/season/{n} и държете всяка алтернативна подредба от страната на TheTVDB. Направете тази проверка на десетте си най-гледани сериала, преди да преместите останалите.

Всяко извикване се брои като една заявка в 60-секундния прозорец, а 429 носи Retry-After. Вижте търсене по външен идентификатор и лимити на заявките.

Цени

amodb е предплатен без автоматично подновяване. Изберете 1, 3, 6, 12 или 24 месеца и един от три плана за 20, 40 или 120 заявки в минута. По-дългите периоди дават отстъпка 10, 20, 30 или 40 процента, а всеки план получава всички данни. Няма безплатен план. Сумите са на страницата с цените.