Dokumentace amodb
Začněte rychlým startem a první volání zvládnete za dvě minuty. Pak si přečtěte, jak fungují klíče, limity požadavků, chyby, jazyky a obrázky. amodb zachovává cesty a JSON TMDB v3 a OMDb, takže většina stránek vysvětluje, co je stejné, co amodb přidává a v jakých několika místech se liší.
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}` },
});
const data = await res.json();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,
)
data = res.json()<?php
$ch = curl_init("https://api.amodb.dev/3/movie/550?language=en-US");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("AMODB_KEY")],
]);
$data = json_decode(curl_exec($ch), true);req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/550?language=en-US", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var data map[string]any
json.NewDecoder(res.Body).Decode(&data)Základní URL
| Použití | Základní URL | Parametr klíče |
|---|---|---|
| Styl TMDB v3 | https:/ | api_key nebo Authorization: Bearer |
| Styl OMDb | https:/ | apikey |
| Obrázky | https:/ | žádný |
| Katalog tarifů | https:/ | žádný |
Začněte zde
-
První volání amodb: získejte klíč, vyžádejte detail filmu v curl, JavaScriptu, Pythonu, PHP nebo Go a načtěte plakát z img.amodb.dev. Za méně než 2 minuty.
-
Jak poslat klíč amodb: api_key v dotazu, hlavička Authorization Bearer nebo apikey pro volání OMDb. Formát klíče, uložení, rotace a chyby 401.
-
amodb omezuje klíč počtem požadavků za minutu v klouzavém okně 60 sekund: 20, 40 nebo 120 podle tarifu. Čtěte hlavičky limitu a řešte 429 pomocí Retry-After.
Koncepty
-
Každá chyba amodb se stavem HTTP, status_code a zprávou TMDB a také tvar chyby OMDb. Co která znamená a co má váš klient udělat v dalším kroku.
-
amodb vrací názvy, popisy a jména ve 14 jazycích. Do language předejte tag ve stylu TMDB, např. ru-RU nebo pt-BR; jakýkoli jiný tag použije angličtinu.
-
Načítejte plakáty, pozadí a profilové fotky z img.amodb.dev s cestami a velikostmi TMDB od w92 po original. Bez klíče, cache 30 dní, jeden vzor URL pro vše.
Zdroje
-
Datovaný přehled změn API amodb, hostitele obrázků img.amodb.dev, tarifů a webu. Nové záznamy jsou nahoře, s popisem změny a tím, co musíte udělat vy.
-
Jak zjistit, zda amodb běží: veřejný endpoint pro kontrolu stavu, chybové kódy, které ukazují na incident, a jak nahlásit problém s údaji, které potřebujeme.
Reference API
Všechny endpointyFilmy
-
/3/movie/{movie_id} -
/3/movie/{movie_id}/credits -
API obrázků a hostitel obrázků
/3/movie/{movie_id}/images -
/3/movie/{movie_id}/videos -
/3/movie/{movie_id}/translations -
/3/movie/{movie_id}/keywords
Seriály
-
/3/tv/{series_id} -
/3/tv/{series_id}/season/{season_number}
Lidé
-
/3/person/{person_id}
Vyhledávání a seznamy
-
/3/search/movie -
/3/discover/movie -
/3/trending/{media_type}/{time_window} -
/3/genre/movie/list -
/3/collection/{collection_id} -
/3/company/{company_id} -
/3/find/{external_id}
Rozšíření amodb
-
/3/movie/{movie_id}/ratings -
/3/movie/{movie_id}/moods -
/3/movie/{movie_id}/soundtracks -
/3/movie/{movie_id}/showtimes
Styl OMDb
-
/omdb/
Návody
Všechny návodyDalší návody a přehledy
-
Přímá srovnání amodb s dalšími API s metadaty filmů a seriálů: kompatibilita, jazyky, limity, obrázky a ceny, s čísly, která si můžete ověřit.
-
Jak týmy používají amodb pro data o filmech a seriálech: katalogy, media servery, doporučovací nástroje, boty a výzkum, s endpointy a limity pro každý případ.