amodb vs TMDB

Comparația pe scurt

amodb este un API independent care vorbește același protocol ca TMDB v3. Un client scris pentru TMDB citește de la amodb după ce schimbi URL-ul de bază și cheia, atâta timp cât nu apelează o cale din tabelul cu apeluri neoferite de mai jos. Alegerea ține deci de termeni, extra și câteva lipsuri. TMDB oferă un API gratuit pentru utilizări eligibile, în termenii proprii. amodb este un API doar pentru citire, cu plată, cu 14 limbi, cinci blocuri de date în plus și o limită numărată pe cheie.

Paritatea endpoint-urilor

Fiecare rând arată o cale de citire TMDB v3 și cum se comportă pe https://api.amodb.dev/3.

Nu este oferit de amodb

Aceste apeluri TMDB v3 nu au echivalent. Căile necunoscute răspund 404 cu status_code 34, iar metodele de scriere răspund 405 cu status_code 37.

Dacă adaugi aggregate_credits sau changes la append_to_response, amodb ignoră numele fără eroare, deci cheia pur și simplu lipsește din corp.

Comparația funcțiilor

Ce diferă în detaliu

• Termeni. TMDB îți cere să citești termenii lui pentru utilizare comercială și atribuire. amodb se vinde pe perioadă plătită în avans, nu are reînnoire automată, nivel gratuit sau perioadă de probă.
• Limbi. amodb servește en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it și es. Acceptă etichete TMDB precum ru-RU și pt-BR. Germana, japoneza și coreeana revin la en, în timp ce original_title păstrează titlul sursă. Pentru acoperirea de limbi a TMDB, vezi documentația lor. Vezi limbi.
• Extensii. append_to_response acceptă și moods, soundtracks, ratings, wikidata și showtimes, iar fiecare are propria cale sub filme și seriale.
• ID-uri externe. /3/find rezolvă imdb_id, tvdb_id, wikidata_id, kinopoisk_id, facebook_id, twitter_id și instagram_id. Sursele freebase_mid, freebase_id, tvrage_id, tiktok_id și youtube_id sunt acceptate, dar întorc array-uri goale. Un external_source lipsă sau necunoscut răspunde 400 cu status_code 22.
• Goale prin proiectare. Imaginile, videoclipurile și traducerile de sezon, precum și description al unei companii sunt mereu goale. Recenziile și created_by la un serial sunt completate doar pentru câteva titluri. external_ids de sezon și de episod sunt toate null.
• Titluri pentru adulți. include_adult este ignorat. Titlurile și persoanele pentru adulți nu sunt servite niciodată și răspund 404.
• Imagini. Calea CDN este https://img.amodb.dev/t/p/{size}/{file}. Nu e nevoie de cheie, iar fișierele stau în cache 30 de zile.
• Limite. Fereastra este de 60 de secunde glisante pe cheie. Antetele arată numărul rămas, iar loviturile de cache se numără tot, pentru că verificarea limitei rulează prima.
• Independență. Catalogul provine din surse publice și deschise și din îmbogățirea noastră. O structură comună nu garantează valori identice pentru fiecare câmp al fiecărui titlu.

Când TMDB se potrivește mai bine

• Utilizare eligibilă gratuită. Nu e nevoie de plată, iar amodb nu poate egala asta.
• Scrieri. Evaluarea unui titlu, crearea unei liste și sesiunile de cont funcționează pe TMDB. Pe amodb întorc 405.
• Fluxuri de modificări. TMDB listează ID-urile care s-au schimbat. amodb nu are un astfel de flux, așa că reîmprospătezi după propriul program.
• Credite agregate și căutări de credite. Ambele răspund 404 pe amodb. Folosește /credits pe titlu.
• Nevoi de limbi mai largi. Dacă interfața ta cere o limbă din afara celor 14, verifică mai întâi TMDB.
• Aprobare existentă. O echipă care a trecut TMDB printr-o revizuire juridică ar trebui să cântărească costul unei a doua revizuiri.

Migrarea la amodb

Schimbarea înseamnă o linie pe cerere.

# 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"

Înainte de trecere, compară structura câtorva răspunsuri unul lângă altul. Acest script afișează cheile de nivel superior pe care o parte le întoarce și cealaltă nu.

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

Câmpurile opționale pot diferi pentru un titlu dat, așa că tratează o cheie lipsă ca pe un indiciu de verificat, nu ca pe un verdict. Apoi parcurge această listă:

1. Alege un plan la prețuri, apoi creează o cheie în panoul contului tău.
2. Mută URL-ul de bază și cheia în configurație.
3. Citește images.secure_base_url din /3/configuration.
4. Caută în codul tău apelurile de scriere și căile din tabelul cu apeluri neoferite. Păstrează scrierile pe TMDB și înlocuiește restul.
5. Adaugă un handler pentru 429 care așteaptă Retry-After secunde. Vezi limite de cereri și erori.

Prețuri

amodb este plătit în avans. Alege 1, 3, 6, 12 sau 24 de luni, cu reduceri de 0, 10, 20, 30 sau 40 la sută, și unul dintre cele trei planuri de 20, 40 sau 120 de cereri pe minut. Fiecare plan întoarce toate datele și niciunul nu se reînnoiește singur. Vezi prețuri pentru sume.