Языки

amodb поддерживает 14 базовых языков: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it и es. Передавайте в параметре language тег в стиле TMDB, например ru-RU, pt-BR или zh-CN. amodb берет из тега базовый язык. Любой другой язык откатывается на английский, поэтому запрос никогда не падает из-за тега.

Обновлено Открыть в Markdown

14 языков

CodeLanguageNative nameExample tag
en English English en-US
ru Russian Русский ru-RU
uk Ukrainian Українська uk-UA
be Belarusian Беларуская be-BY
zh Chinese 中文 zh-CN
pt Portuguese Português pt-BR
bg Bulgarian Български bg-BG
he Hebrew עברית he-IL
cs Czech Čeština cs-CZ
ro Romanian Română ro-RO
fr French Français fr-FR
pl Polish Polski pl-PL
it Italian Italiano it-IT
es Spanish Español es-ES

Как работает параметр

Добавьте language к любому вызову в стиле TMDB. amodb принимает формы тега, которые отправляют клиенты TMDB:

  • ru-RU, pt-BR и zh-CN, с регионом
  • ru и pt, без региона
  • pt_BR, с подчеркиванием

amodb берет часть до первого - или _, приводит ее к нижнему регистру и отдает этот язык, если он один из 14. Любой другой язык возвращает английский. Кэш edge хранит каждый базовый язык один раз, поэтому ru и ru-RU используют одну запись кэша.

bashjspy
curl "https://api.amodb.dev/3/movie/550?language=uk-UA" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/tv/1396?language=pl-PL", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const show = await res.json();
console.log(show.name, show.overview);
res = requests.get(
    "https://api.amodb.dev/3/search/movie",
    params={"query": "Матрица", "language": "ru-RU"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)

Что переводится

Переводятся те же поля, что и в TMDB: title и overview для фильмов, name и overview для сериалов, сезонов и серий, tagline, названия жанров и биографии людей. Поля без перевода на выбранном языке возвращаются так же, как в TMDB, часто пустой строкой, поэтому держите запрос на английском как запасной вариант для показа.

Иврит и текст справа налево

Текст на иврите приходит как обычный Unicode. Задайте dir="rtl" или dir="auto" у элемента, который его показывает; API не добавляет маркеры направления.

Вопросы и ответы

Возвращает ли pt-PT другой текст, чем pt-BR?

Нет. amodb читает только базовый язык, поэтому pt-PT и pt-BR оба возвращают португальский. То же относится к zh-CN и zh-TW: оба возвращают китайский.

Что будет с языком вне этих 14?

Вызов проходит успешно и возвращает английский. Например, language=de-DE вернет английское название и описание.