Ключ, съвместим с TMDB, в четири стъпки

amodb продава ключове за собственото си API, което запазва пътищата и JSON на TMDB v3. Това не е ключ от TMDB и не работи на api.themoviedb.org. Получавате ключ със същата форма, 32 шестнадесетични знака с малки букви, който клиентът ви за TMDB приема след една промяна на базовия URL адрес.

  1. Отворете страницата с цените и изберете план: 20, 40 или 120 заявки в минута. Всеки план връща всички данни.
  2. Влезте с имейла си. 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 и заявка за ключ на сайта на TMDBИмейл, 6-цифрен код, плащане, после създавате ключа в акаунта си
Търговска употребаВижте условията на TMDB за търговска употреба и посочване на авторствоРазрешена според условията на amodb
Лимит на заявкитеОпределя го TMDB, вижте документацията им20, 40 или 120 заявки в минута според плана
ДанниДанни на TMDBФорма на TMDB v3, плюс ratings, moods, soundtracks, wikidata и showtimes през append_to_response
Формат на ключаКлюч за v3, 32 шестнадесетични знака32 шестнадесетични знака с малки букви
Базов URL адресhttps://api.themoviedb.org/3https://api.amodb.dev/3
Методи за записМетоди за акаунт, списъци и оценкиНе се предлагат, връщат 405

Кога безплатният ключ за TMDB е достатъчен

Останете на безплатен ключ за TMDB за личен или учебен проект, който се вписва в условията на TMDB. Ако ползването ви отговаря на изискванията, TMDB не струва нищо и amodb не може да се мери с това.

Ползвайте ключ за amodb, когато проектът е търговски и искате платено споразумение, когато ви трябва твърд лимит в минута, около който да планирате, или когато страницата на едно заглавие трябва да получи рейтинги от пет източника с едно извикване. Първо проверете празнините: методите за запис, потоците changes и някои други пътища не се предлагат. Те са изброени на страницата Алтернатива на TMDB API и в amodb срещу TMDB.

Търговска употреба и лимити

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

Планът определя скоростта. Всеки отговор носи X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, а 429 добавя Retry-After. Подробности има в лимитите на заявките.