Выявы

Кожны шлях да выявы ў адказе amodb загружаецца з https://img.amodb.dev/t/p/{size}/{file}. Памеры адпавядаюць TMDB: w92, w154, w185, w300, w342, w500, w780, w1280, h632 і original. Выявам ключ не патрэбны, і яны не ўлічваюцца ў вашым ліміце. Edge трымае іх 30 дзён, а /3/configuration вяртае базавыя URL.

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

Text
https://img.amodb.dev/t/p/{size}/{file}

{file} ёсць шляхам з поля адказу, напрыклад poster_path, backdrop_path, profile_path, still_path або logo_path. Ён ужо пачынаецца з /.

Text
https://img.amodb.dev/t/p/w500/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg

Памеры

ПамерШырыня або вышыняДля чаго падыходзіць
w92Шырыня 92 pxПадказкі пошуку
w154Шырыня 154 pxШчыльныя спісы
w185Шырыня 185 pxСеткі на камп’ютары, фота персон
w300Шырыня 300 pxМініяцюры фонавых выяў, Poster у OMDb
w342Шырыня 342 pxСеткі на тэлефонах з экранамі высокай шчыльнасці
w500Шырыня 500 pxСтаронкі дэталяў
w780Шырыня 780 pxВялікія постэры, сярэднія фонавыя выявы
w1280Шырыня 1280 pxФонавыя выявы на ўсю шырыню
h632Вышыня 632 pxФота персон у поўную вышыню
originalПамер крыніцыСпампоўка і друк

Постэры маюць прапорцыі 2:3. Задайце width і height для <img>, каб старонка не зрушвалася падчас загрузкі.

Базавыя URL з эндпоінта канфігурацыі

GET /3/configuration вяртае тую ж структуру, што і TMDB. Кліенты, якія будуюць URL выяў з яе, працуюць без змен.

Edge трымае /3/configuration 24 гадзіны, таму чытаць яго дастаткова адзін раз на дзень.

JSON
{
  "images": {
    "base_url": "http://img.amodb.dev/t/p/",
    "secure_base_url": "https://img.amodb.dev/t/p/",
    "poster_sizes": ["w92", "w154", "w185", "w342", "w500", "w780", "original"]
  }
}
JavaScript
const base = "https://img.amodb.dev/t/p";
const srcset = ["w185", "w342", "w500"]
  .map((size) => `${base}/${size}${movie.poster_path} ${size.slice(1)}w`)
  .join(", ");

const html = `<img src="${base}/w342${movie.poster_path}" srcset="${srcset}"
  sizes="(min-width: 64rem) 185px, 33vw" width="342" height="513"
  alt="${movie.title} poster" loading="lazy">`;

Кэшаванне

Выявы застаюцца ў edge-кэшы 30 дзён. Захоўвайце шлях да файла разам са сваім запісам і будуйце URL пры адлюстраванні, каб потым змяніць памер без новых выклікаў API.

Пытанні і адказы

Ці можна ўстаўляць URL выяў наўпрост у тэгі img?

Так. URL выяў не нясуць ключа, таму іх бяспечна размяшчаць на публічных старонках. Выбірайце найменшы памер, які пакрывае шырыню на экране, памножаную на шчыльнасць пікселяў прылады.

Ці ўлічваюцца запыты выяў у маім ліміце запытаў?

Не. Хост выяў не чытае ключ, таму постэры і фонавыя выявы ніколі не расходуюць вашы запыты ў хвіліну.