Як отримати сумісний із TMDB ключ за чотири кроки

amodb продає ключі для власного API, яке зберігає шляхи й JSON TMDB v3. Це не ключ від TMDB, і він не працює на api.themoviedb.org. Ви отримуєте ключ тієї самої форми, 32 шістнадцяткові символи нижнього регістру, який ваш клієнт TMDB приймає після однієї зміни базового URL.

  1. Відкрийте сторінку цін і оберіть тариф: 20, 40 або 120 запитів на хвилину. Кожен тариф повертає всі дані.
  2. Увійдіть за допомогою email. amodb надсилає 6-значний код, який діє 10 хвилин. Пароля немає.
  3. Оплатіть карткою, через Apple Pay або Google Pay на термін від 1 до 24 місяців. Автоматичного поновлення немає.
  4. Відкрийте Акаунт, потім Ключі API і створіть ключ. Скопіюйте його одразу, бо повний ключ показується один раз.

Ці кроки займають близько хвилини, а ключ працює, щойно платіж підтверджено.

Використання ключа: змініть базовий URL

Залиште свій код для TMDB і змініть два значення: базовий URL і ключ. Працюють обидва способи надсилання ключа: api_key у запиті й заголовок Authorization: Bearer.

Shell 
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

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

Той самий виклик із заголовком Bearer трьома мовами:

bashjspy 
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])

Відповідь має формат TMDB v3:

JSON 
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}

Читайте images.secure_base_url із /3/configuration, щоб посилання на постери вказували на img.amodb.dev. Для зображень ключ не потрібен. Докладніше про надсилання ключа на сторінці автентифікація, а ширший покроковий приклад у швидкому старті.

Безкоштовний ключ TMDB і ключ amodb: порівняння

Правильний вибір залежить від вашого проєкту й умов, а не від списку функцій. Стовпець TMDB лише повторює те, що TMDB публікує в загальному вигляді. Актуальні правила дивіться в умовах і документації TMDB.

Безкоштовний ключ TMDBКлюч amodb
ЦінаБезкоштовно для відповідного використання за умовами TMDBПлатно, передплата на термін від 1 до 24 місяців, без пробного періоду
Як отриматиАкаунт TMDB і запит ключа на сайті TMDBEmail, 6-значний код, оплата, потім створення ключа в акаунті
Комерційне використанняПеревірте умови TMDB щодо комерційного використання й зазначення авторстваДозволено умовами amodb
Ліміт запитівЗадає TMDB, дивіться їхню документацію20, 40 або 120 запитів на хвилину залежно від тарифу
ДаніДані TMDBФормат TMDB v3, плюс ratings, moods, soundtracks, wikidata і showtimes через append_to_response
Формат ключаКлюч v3, 32 шістнадцяткові символи32 шістнадцяткові символи нижнього регістру
Базовий URLhttps://api.themoviedb.org/3https://api.amodb.dev/3
Методи записуМетоди акаунта, списків і оцінокНе пропонуються, відповідають 405

Коли достатньо безкоштовного ключа TMDB

Залишайтеся на безкоштовному ключі TMDB для особистого чи навчального проєкту, який вкладається в умови TMDB. Якщо ваш випадок підходить, TMDB нічого не коштує, і з цим amodb не зрівняється.

Обирайте ключ amodb, коли проєкт комерційний і вам потрібна платна угода, коли потрібен фіксований ліміт на хвилину, під який можна планувати, або коли сторінка фільму має отримувати рейтинги з п'яти джерел одним викликом. Спершу перевірте, чого немає: методи запису, стрічки changes і кілька інших шляхів не пропонуються. Їх перелічено на сторінці альтернатива TMDB API і в матеріалі amodb vs TMDB.

Комерційне використання та ліміти

Комерційне використання дозволено умовами amodb. Ви можете показувати дані у власних застосунках, на сайтах, у ботах і внутрішніх інструментах, а також кешувати відповіді, щоб заощаджувати запити. Не можна перепродувати сирий доступ до API, публікувати масові вивантаження, ділитися ключами й відкривати додаткові акаунти, щоб підвищити ліміт. Повний перелік наведено в політиці прийнятного використання.

Ліміт задає тариф. Кожна відповідь містить X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset, а відповідь 429 додає Retry-After. Подробиці на сторінці ліміти запитів.