Атрымаць ключ API

Дакументацыя amodb

Пачніце з хуткага старту, каб зрабіць першы выклік за дзве хвіліны. Потым прачытайце, як працуюць ключы, ліміты запытаў, памылкі, мовы і выявы. amodb захоўвае шляхі і JSON TMDB v3 і OMDb, таму большасць старонак тут тлумачаць, што супадае, што amodb дадае і ў якіх некалькіх месцах ён адрозніваецца.

Абноўлена Адкрыць у Markdown

Першы запыт
bashjspyphpgo 
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 v3https://api.amodb.dev/3api_key або Authorization: Bearer
Стыль OMDbhttps://api.amodb.dev/omdb/apikey
Выявыhttps://img.amodb.dev/t/p/{size}/{file}няма
Каталог планаўhttps://api.amodb.dev/plansняма

З чаго пачаць

  • Хуткі старт

    Першы выклік да 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-статусам, TMDB status_code і паведамленнем, а таксама форма памылкі OMDb. Што азначае кожная і што рабіць вашаму кліенту далей.

  • Мовы

    amodb аддае назвы, апісанні і імёны на 14 мовах. Перадайце тэг у стылі TMDB, напрыклад ru-RU або pt-BR, у language; любы іншы тэг замяняецца англійскай мовай.

  • Выявы

    Загружайце постэры, фонавыя выявы і фота персон з img.amodb.dev па шляхах і памерах TMDB, ад w92 да original. Ключ не патрэбны, кэш 30 дзён, адзін шаблон URL.

Рэсурсы

  • Спіс змен

    Спіс змен у API amodb, на хосце выяў img.amodb.dev, у планах і на сайце па датах. Новыя запісы ўверсе: што змянілася і што вам трэба зрабіць.

  • Статус

    Як праверыць, ці працуе amodb: публічны эндпоінт health, коды памылак, што паказваюць на інцыдэнт, і як паведаміць пра праблему з патрэбнымі нам звесткамі.

Даведнік API

Усе эндпоінты

Фільмы

Серыялы

Людзі

Пошук і спісы

Пашырэнні amodb

У стылі OMDb

Дапаможнікі

Усе дапаможнікі

Іншыя дапаможнікі і раздзелы

  • Параўнанні amodb

    Параўнанні amodb з іншымі API метаданых фільмаў і серыялаў: сумяшчальнасць, мовы, ліміты, выявы і цэны з лікамі, якія можна праверыць.

  • Сцэнары выкарыстання

    Як каманды выкарыстоўваюць amodb для даных пра фільмы і серыялы: каталогі, медыясерверы, рэкамендацыі, боты і даследаванні, з патрэбнымі эндпоінтамі і лімітамі.