# שפות

> 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 קורא את שפת הבסיס מהתגית. כל שפה אחרת חוזרת לאנגלית, ולכן בקשה אף פעם לא נכשלת בגלל התגית שלה.

## 14 השפות

| Code | Language   | Native name | Example 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` חולקים רשומת מטמון אחת.

```bash
curl "https://api.amodb.dev/3/movie/550?language=uk-UA" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
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);
```

```python
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 מחזיר את הכותרת ואת התקציר באנגלית.

## עמודים קשורים

- [תמונות](https://amodb.dev/he/images/): טענו פוסטרים, תמונות רקע ותמונות פרופיל מ-img.amodb.dev עם נתיבים וגדלים של TMDB מ-w92 ועד original. בלי מפתח, מטמון ל-30 יום ותבנית כתובת אחת לכולן.
- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.
- [שגיאות](https://amodb.dev/he/errors/): כל שגיאה של amodb עם סטטוס HTTP, status_code והודעה של TMDB, וגם מבנה השגיאה של OMDb. מה כל אחת מהן אומרת ומה הלקוח שלכם צריך לעשות כשהיא מופיעה.

עודכן: 2026-10-18. Source: https://amodb.dev/he/languages/