amodb против TMDB

Краткое сравнение

amodb является независимым API, работающим по тому же протоколу, что и TMDB v3. Клиент, написанный для TMDB, читает данные из amodb после смены базового URL и ключа, если он не вызывает путь из таблицы не предлагаемых вызовов ниже. Поэтому выбор зависит от условий, дополнений и нескольких пробелов. TMDB предлагает бесплатный API для подходящего использования на своих условиях. amodb, напротив, платный API только для чтения с 14 языками, пятью дополнительными блоками данных и лимитом, который считается на ключ.

Совместимость эндпоинтов

Каждая строка показывает путь чтения TMDB v3 и его поведение на https://api.amodb.dev/3.

Что amodb не предлагает

У этих вызовов TMDB v3 нет аналога. Неизвестные пути отвечают 404 со status_code 34, а методы записи отвечают 405 со status_code 37.

Если добавить aggregate_credits или changes в append_to_response, amodb игнорирует это имя без ошибки, поэтому ключ просто отсутствует в теле ответа.

Сравнение возможностей

Подробные отличия

• Условия. TMDB просит изучить его условия коммерческого использования и указания авторства. amodb продается по предоплаченным периодам, без автоматического продления, без бесплатного тарифа и без пробного периода.
• Языки. amodb поддерживает en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it и es. Он принимает теги TMDB, например ru-RU и pt-BR. Немецкий, японский и корейский откатываются на en, а original_title сохраняет исходное название. Охват языков TMDB уточняйте в их документации. См. языки.
• Расширения. append_to_response принимает также moods, soundtracks, ratings, wikidata и showtimes, и у каждого есть собственный путь для фильмов и сериалов.
• Внешние ID. /3/find разрешает imdb_id, tvdb_id, wikidata_id, kinopoisk_id, facebook_id, twitter_id и instagram_id. Источники freebase_mid, freebase_id, tvrage_id, tiktok_id и youtube_id принимаются, но возвращают пустые массивы. Отсутствующий или неизвестный external_source отвечает 400 со status_code 22.
• Пусто по замыслу. Изображения, видео и переводы сезонов, а также description компании всегда пусты. Отзывы и created_by у сериала заполнены лишь для нескольких тайтлов. external_ids сезонов и серий везде равны null.
• Контент для взрослых. include_adult игнорируется. Тайтлы и люди для взрослых никогда не отдаются и отвечают 404.
• Изображения. Путь CDN: https://img.amodb.dev/t/p/{size}/{file}. Ключ не нужен, файлы кэшируются на 30 дней.
• Лимиты. Окно скользящее, 60 секунд на ключ. Заголовки показывают остаток, а попадания в кэш тоже засчитываются, потому что проверка лимита выполняется первой.
• Независимость. Каталог собирается из публичных и открытых источников и нашего собственного обогащения. Общая структура не гарантирует одинаковых значений каждого поля у каждого тайтла.

Когда TMDB подходит лучше

• Бесплатное подходящее использование. Платить не нужно, и amodb здесь не сможет сравниться.
• Запись. Оценка тайтла, создание списка и сессии аккаунта работают в TMDB. В amodb они возвращают 405.
• Ленты changes. TMDB перечисляет ID, которые изменились. В amodb такой ленты нет, поэтому обновление идет по вашему расписанию.
• Aggregate credits и поиск по credit. Оба отвечают 404 в amodb. Используйте /credits у тайтла.
• Потребность в других языках. Если вашему интерфейсу нужен язык вне этих 14, сначала проверьте TMDB.
• Уже полученное одобрение. Команде, которая согласовала TMDB с юристами, стоит учесть цену второго согласования.

Миграция на amodb

Изменение сводится к одной строке на запрос.

# before: TMDB_BASE is your current TMDB v3 base URL
curl -s "$TMDB_BASE/movie/550?api_key=$TMDB_KEY"

# after
curl -s "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"

Перед переключением сравните структуру нескольких ответов бок о бок. Этот скрипт печатает ключи верхнего уровня, которые возвращает одна сторона и не возвращает другая.

async function topLevelKeys(base, key, path) {
  const res = await fetch(`${base}${path}?api_key=${key}`);
  if (!res.ok) throw new Error(`${path} returned ${res.status}`);
  return Object.keys(await res.json()).sort();
}

for (const path of ['/movie/550', '/tv/1396', '/person/31']) {
  const current = await topLevelKeys(process.env.TMDB_BASE, process.env.TMDB_KEY, path);
  const next = await topLevelKeys('https://api.amodb.dev/3', process.env.AMODB_KEY, path);
  const missing = current.filter((k) => !next.includes(k));
  console.log(path, missing.length ? `missing: ${missing.join(', ')}` : 'same keys');
}

Необязательные поля у конкретного тайтла могут отличаться, поэтому воспринимайте отсутствующий ключ как повод проверить, а не как приговор. Затем пройдите по этому списку:

1. Выберите тариф на странице цены, затем создайте ключ в личном кабинете.
2. Вынесите базовый URL и ключ в конфигурацию.
3. Читайте images.secure_base_url из /3/configuration.
4. Найдите в коде вызовы записи и пути из таблицы не предлагаемых. Вызовы записи оставьте в TMDB, остальное замените.
5. Добавьте обработчик 429, который ждет Retry-After секунд. См. лимиты запросов и ошибки.

Цены

amodb работает по предоплате. Выберите 1, 3, 6, 12 или 24 месяца со скидкой 0, 10, 20, 30 или 40 процентов и один из трех тарифов на 20, 40 или 120 запросов в минуту. Любой тариф возвращает все данные, и ни один не продлевается сам. Суммы указаны на странице цены.