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

Кое API да изберете

TMDB предлага безплатно API за допустимо ползване по собствените си условия, с ключове за API v3 и токени v4. Прочетете тези условия за търговска употреба и посочване на авторство, преди да пуснете продукта. Изберете алтернатива, когато искате платено споразумение, лимит, около който да планирате, или повече данни във всеки отговор. amodb е независимо API, което работи по протокола на TMDB v3 за четене, така че смяната означава нов базов URL и нов ключ. То е само за четене и някои пътища на TMDB не се предлагат, както е изброено по-долу.

Останете на TMDB, ако безплатните условия пасват на проекта ви и нищо от следващия раздел не се отнася за вас.

Сигнали, че ви трябва алтернатива

Пет проверки помагат да решите. Пускайте ги върху собствения си трафик и собствения си договор, а не върху списък с функции.

Попаденията в кеша също се броят. Проверката на ключа и лимитът на заявките се изпълняват преди edge кеша, така че повторна заявка пак харчи една от вашите заявки в минута. Планирайте по общия брой заявки, а не по пропуските на кеша.

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

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

• Лимити, които можете да прочетете. Всеки отговор с ключ носи X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset в секунди. 429 добавя Retry-After. Числата са обяснени на страницата лимити на заявките.
• Допълнителни блокове в едно извикване. Рейтинги от пет източника, индикатори за настроение, саундтраци, факти от Wikidata и прожекции в кината пристигат през append_to_response, така че една страница на заглавие може да ползва една заявка.
• Повече източници на външни id. /3/find разрешава imdb_id, tvdb_id, wikidata_id и kinopoisk_id, а също facebook_id, twitter_id и instagram_id. Вижте търсене по външен идентификатор.
• OMDb на същия ключ. https://api.amodb.dev/omdb/ отговаря на извиквания в стил OMDb с параметър apikey, което помага, когато две ваши системи ползват различни протоколи.
• Известни срокове на кеша. Детайлите и участниците стоят 6 часа на edge, тенденциите и discover 30 минути, търсенето 10 минути, конфигурацията 24 часа, а изображенията 30 дни.

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

• Безплатни проекти. Ако ползването ви отговаря на безплатните условия, TMDB не струва нищо и amodb не може да се мери с това.
• Методи за запис на потребители. TMDB предлага методи за запис за акаунт, сесия, оценки и списъци. amodb отговаря на тях с 405 и status_code 37, така че приложение, в което хората влизат и оценяват заглавия, трябва да остави TMDB за тази част.
• Потоци с промени. TMDB изброява id, които са се променили. amodb няма такъв поток, затова обновявате по собствен график.
• Над 14 езика. amodb не обслужва текст на интерфейса на немски, японски и корейски и се връща към английски. Оригиналните заглавия пак идват в original_title и original_name. За други езици в TMDB вижте документацията им.
• Условия, които вече сте приели. Ако юридическата проверка за TMDB е минала, смяната ви струва още една проверка.

Какво amodb не предлага

Проверете кода си спрямо този списък преди прехода. Пълната таблица е на страницата amodb срещу TMDB.

Две поведения са тихи. Име на append_to_response, което amodb не познава, като aggregate_credits, се игнорира без грешка. Параметърът include_adult също се игнорира, защото заглавия и личности за възрастни никога не се обслужват.

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

1. Изберете план на страницата с цените и създайте ключ в личния си профил.
2. Сменете базовия URL и ключа на едно място, както по-долу.
3. Прочетете images.secure_base_url от /3/configuration, за да ползват връзките към изображения img.amodb.dev.
4. Махнете извикванията към методи за запис и към пътищата от таблицата по-горе.
5. Обработете 429, като изчакате Retry-After секунди.

const config = {
  // before: baseUrl held your current TMDB v3 base URL
  baseUrl: 'https://api.amodb.dev/3',
  apiKey: process.env.AMODB_KEY,
};

const res = await fetch(`${config.baseUrl}/movie/550?language=en-US`, {
  headers: { Authorization: `Bearer ${config.apiKey}` },
});
if (!res.ok) throw new Error(`request failed with status ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);

Пуснете съществуващите си тестове срещу двата базови URL адреса преди прехода. Споделената форма не гарантира еднакви стойности, затова сравнете извадка от собствените си заглавия. Пълното ръководство е в бърз старт, а таблица лице в лице е на страницата amodb срещу TMDB.

Обработката на грешки се пренася

Неуспешните извиквания връщат тялото на TMDB {"success": false, "status_code": N, "status_message": "..."}, така че код, който разклонява по status_code, не се нуждае от пренаписване.

Третирайте 402 като сигнал да подновите ръчно, защото нищо не се подновява автоматично. Пълният списък е на страницата грешки.

Цени

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