Dokumentacja amodb
Zacznij od szybkiego startu, by wykonać pierwsze wywołanie w dwie minuty. Potem przeczytaj, jak działają klucze, limity żądań, błędy, języki i obrazy. amodb zachowuje ścieżki i JSON z TMDB v3 i OMDb, więc większość stron wyjaśnia, co jest takie samo, co dodaje amodb i w których nielicznych miejscach się różni.
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)Bazowe adresy URL
| Zastosowanie | Bazowy URL | Parametr klucza |
|---|---|---|
| Styl TMDB v3 | https:/ | api_key lub Authorization: Bearer |
| Styl OMDb | https:/ | apikey |
| Obrazy | https:/ | brak |
| Katalog planów | https:/ | brak |
Zacznij tutaj
-
Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut.
-
Jak wysłać klucz amodb: api_key w zapytaniu, nagłówek Authorization Bearer albo apikey dla wywołań OMDb. Format klucza, przechowywanie, rotacja i błędy 401.
-
amodb limituje klucz liczbą żądań na minutę w przesuwanym oknie 60 sekund: 20, 40 lub 120 zależnie od planu. Czytaj nagłówki limitu i obsłuż 429 z Retry-After.
Koncepty
-
Każdy błąd amodb ze statusem HTTP, status_code i komunikatem TMDB oraz kształt błędu OMDb. Co oznacza każdy z nich i co powinien zrobić twój klient dalej.
-
amodb serwuje tytuły, opisy i nazwy w 14 językach. Podaj tag w stylu TMDB, np. ru-RU lub pt-BR, w language; każdy inny tag wraca do angielskiego.
-
Ładuj plakaty, tła i zdjęcia osób z img.amodb.dev na ścieżkach i w rozmiarach TMDB, od w92 do original. Bez klucza, cache 30 dni, jeden wzorzec URL.
Zasoby
-
Datowana lista zmian w API amodb, hoście obrazów img.amodb.dev, planach i na stronie. Nowe wpisy są na górze, z opisem zmiany i tym, co musisz zrobić.
-
Jak sprawdzić, czy amodb działa: publiczny endpoint health, kody błędów wskazujące awarię i jak zgłosić problem z danymi, których potrzebujemy do diagnozy.
Dokumentacja API
Wszystkie endpointyFilmy
-
/3/movie/{movie_id} -
/3/movie/{movie_id}/credits -
/3/movie/{movie_id}/images -
/3/movie/{movie_id}/videos -
/3/movie/{movie_id}/translations -
/3/movie/{movie_id}/keywords
Seriale
-
/3/tv/{series_id} -
API sezonów i odcinków seriali
/3/tv/{series_id}/season/{season_number}
Osoby
-
/3/person/{person_id}
Wyszukiwanie i listy
-
/3/search/movie -
/3/discover/movie -
/3/trending/{media_type}/{time_window} -
/3/genre/movie/list -
/3/collection/{collection_id} -
/3/company/{company_id} -
Wyszukiwanie po zewnętrznym ID
/3/find/{external_id}
Rozszerzenia amodb
-
/3/movie/{movie_id}/ratings -
/3/movie/{movie_id}/moods -
/3/movie/{movie_id}/soundtracks -
/3/movie/{movie_id}/showtimes
Styl OMDb
-
/omdb/
Poradniki
Wszystkie poradnikiWięcej poradników i indeksów
-
Zestawienia amodb z innymi API metadanych filmów i seriali: zgodność, języki, limity, obrazy i ceny, z liczbami, które możesz sprawdzić.
-
Jak zespoły używają amodb do danych o filmach i serialach: katalogi, serwery multimediów, rekomendacje, boty i badania, z potrzebnymi endpointami i limitami.