Мови

amodb обслуговує 14 базових мов: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it та es. Передайте тег у стилі TMDB, наприклад ru-RU, pt-BR або zh-CN, у параметрі language. 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. Усе інше повертає англійську. Кеш на периферії зберігає кожну базову мову один раз, тож 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 повертає англійську назву й опис.