Alternativa k API TMDB

Které API zvolit

TMDB nabízí bezplatné API pro kvalifikované užití podle vlastních podmínek, s klíči API v3 a tokeny v4. Než produkt nasadíte, přečtěte si tyto podmínky komerčního užití a uvádění zdroje. Alternativu zvolte, když chcete placenou smlouvu, limit, podle kterého lze plánovat, nebo víc dat v každé odpovědi. amodb je nezávislé API, které mluví protokolem TMDB v3 pro čtení, takže přechod znamená novou základní URL a nový klíč. Je jen pro čtení a několik cest TMDB se nenabízí, jak je uvedeno níže.

Zůstaňte u TMDB, pokud vašemu projektu bezplatné podmínky vyhovují a nic v další části se vás netýká.

Signály, že potřebujete alternativu

Rozhodnout pomáhá pět kontrol. Spusťte je proti vlastnímu provozu a vlastní smlouvě, ne proti seznamu funkcí.

Zásahy cache se také počítají. Kontrola klíče a limitu proběhne před cache na edge, takže opakovaný požadavek stále spotřebuje jeden z vašich požadavků za minutu. Plánujte podle celkového počtu požadavků, ne podle minutí cache.

Srovnání funkcí

V čem se amodb liší

• Limity, které si přečtete. Každá odpověď s klíčem nese X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset v sekundách. 429 přidává Retry-After. Čísla vysvětluje stránka limity požadavků.
• Další bloky v jednom volání. Hodnocení z pěti zdrojů, měřiče nálady, soundtracky, fakta z Wikidata a promítací časy kin přicházejí přes append_to_response, takže stránka jednoho titulu může použít jediný požadavek.
• Více zdrojů externích ID. /3/find převádí imdb_id, tvdb_id, wikidata_id a kinopoisk_id a také facebook_id, twitter_id a instagram_id. Viz hledání podle externího ID.
• OMDb na stejném klíči. https://api.amodb.dev/omdb/ odpovídá na volání ve stylu OMDb s parametrem apikey, což pomáhá, když dva vaše systémy používají různé protokoly.
• Známé doby cache. Detaily a obsazení zůstávají 6 hodin na edge, trending a discover 30 minut, vyhledávání 10 minut, konfigurace 24 hodin a obrázky 30 dní.

Kdy se TMDB hodí lépe

• Bezplatné projekty. Pokud vaše užití splňuje bezplatné podmínky, TMDB nestojí nic a amodb to nemůže vyrovnat.
• Uživatelské metody pro zápis. TMDB nabízí metody pro zápis účtu, relace, hodnocení a seznamů. amodb na ně odpovídá 405 a status_code 37, takže aplikace, která lidem umožňuje přihlásit se a hodnotit tituly, by pro tuto část měla ponechat TMDB.
• Feedy změn. TMDB uvádí ID, která se změnila. amodb takový feed nemá, obnovujete tedy podle vlastního rozvrhu.
• Více než 14 jazyků. amodb neposkytuje text rozhraní v němčině, japonštině ani korejštině a vrací se k angličtině. Původní názvy přesto přicházejí v original_title a original_name. Další jazyky na TMDB ověřte v jejich dokumentaci.
• Podmínky, které jste už přijali. Pokud je právní posouzení pro TMDB hotové, přechod vás stojí další posouzení.

Co amodb nenabízí

Než přepnete, projděte svůj kód podle tohoto seznamu. Úplná tabulka je na stránce amodb vs TMDB.

Dvě chování jsou tichá. Název v append_to_response, který amodb nezná, například aggregate_credits, se bez chyby ignoruje. Parametr include_adult se také ignoruje, protože tituly a osoby pro dospělé se nikdy neposkytují.

Přechod na amodb

1. Vyberte tarif na stránce ceník a vytvořte klíč v panelu účtu.
2. Základní URL a klíč nahraďte na jednom místě, jak je uvedeno níže.
3. Přečtěte images.secure_base_url z /3/configuration, aby odkazy na obrázky používaly img.amodb.dev.
4. Odstraňte volání metod pro zápis a cest z tabulky výše.
5. Ošetřete 429 čekáním Retry-After sekund.

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);

Před přepnutím spusťte stávající testy proti oběma základním URL. Sdílený tvar nezaručuje shodné hodnoty, porovnejte proto vzorek vlastních titulů. Úplný postup je v rychlém startu a tabulka vedle sebe na stránce amodb vs TMDB.

Zpracování chyb se přenáší

Neúspěšná volání vracejí tělo TMDB {"success": false, "status_code": N, "status_message": "..."}, kód, který větví podle status_code, tedy nepotřebuje přepsat.

402 berte jako signál k ruční obnově, protože se nic neobnovuje automaticky. Úplný seznam je na stránce chyby.

Ceník

amodb je předplacené. Zvolte období 1, 3, 6, 12 nebo 24 měsíců, u kterého je sleva 0, 10, 20, 30 nebo 40 procent, a jeden ze tří tarifů s 20, 40 nebo 120 požadavky za minutu. Každý tarif dostane všechna data a nic se neobnovuje automaticky. Bezplatný tarif ani zkušební verze neexistují. Aktuální částky jsou na stránce ceník.