Документация на amodb
Започнете с бързия старт, за да направите първата си заявка за две минути. После прочетете как работят ключовете, лимитите на заявките, грешките, езиците и изображенията. amodb запазва пътищата и JSON на TMDB v3 и OMDb, затова повечето страници тук обясняват какво е същото, какво добавя amodb и малкото места, където се различава.
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)Базови URL адреси
| Приложение | Базов URL | Параметър за ключа |
|---|---|---|
| Стил TMDB v3 | https:/ | api_key или Authorization: Bearer |
| Стил OMDb | https:/ | apikey |
| Изображения | https:/ | няма |
| Каталог на плановете | https:/ | няма |
Започнете оттук
-
Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
-
Как да изпратите ключа си за amodb: api_key в заявката, заглавка Authorization с Bearer или apikey за OMDb. Формат, съхранение, смяна на ключ и грешките 401.
-
amodb ограничава всеки ключ по заявки в минута в плъзгащ се прозорец от 60 секунди: 20, 40 или 120. Заглавки за лимита и обработка на 429 с Retry-After.
Основни понятия
-
Всяка грешка на amodb с HTTP статус, status_code на TMDB и съобщение, плюс формата на грешките на OMDb. Какво означава всяка и какво да направи клиентът ви.
-
amodb връща заглавия, описания и имена на 14 езика. Подайте таг в стил TMDB, например ru-RU или pt-BR, в language; всеки друг таг се заменя с английски.
-
Зареждайте постери, фонови изображения и снимки от img.amodb.dev с пътищата и размерите на TMDB, от w92 до original. Без ключ, кеш 30 дни, един шаблон на URL.
Ресурси
-
Списък по дати на промените в API на amodb, хоста img.amodb.dev, плановете и сайта. Най-новите са отгоре: какво се е променило и какво да направите.
-
Как да проверите дали amodb работи: публичният ендпойнт за състоянието, кодовете на грешки, които сочат инцидент, и как да подадете сигнал с нужните ни данни.
Справочник на API
Всички ендпойнтиФилми
-
/3/movie/{movie_id} -
/3/movie/{movie_id}/credits -
API за изображения и хост за изображения
/3/movie/{movie_id}/images -
/3/movie/{movie_id}/videos -
/3/movie/{movie_id}/translations -
/3/movie/{movie_id}/keywords
Сериали
-
/3/tv/{series_id} -
API за сезони и епизоди на сериали
/3/tv/{series_id}/season/{season_number}
Хора
-
/3/person/{person_id}
Търсене и списъци
-
/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}
Разширения на amodb
-
/3/movie/{movie_id}/ratings -
/3/movie/{movie_id}/moods -
/3/movie/{movie_id}/soundtracks -
/3/movie/{movie_id}/showtimes
В стил OMDb
-
/omdb/
Ръководства
Всички ръководстваОще ръководства и раздели
-
Сравнения на amodb с други API за метаданни за филми и сериали: съвместимост, езици, лимити, изображения и цени, с числа, които можете да проверите.
-
Как екипите ползват amodb за данни за филми и сериали: каталози, медийни сървъри, препоръки, ботове и проучвания, с ендпойнтите и лимитите за всеки случай.