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.
• Потоци с промени. 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 заявки в минута. Всеки план връща всички данни и нито един не се подновява сам. Вижте сумите на страницата с цените.