# מפתח API של TMDB: מפתח תואם בערך תוך דקה

> כדי לקבל מפתח API של TMDB לפרויקט מסחרי, נכנסים ל-amodb עם אימייל וקוד חד פעמי, משלמים על מסלול ויוצרים מפתח. זה לוקח בערך דקה. למפתח יש הצורה של TMDB v3, ולכן מחליפים את כתובת הבסיס והקוד נשאר כמו שהוא. אין מסלול חינמי.

## מפתח תואם TMDB בארבעה שלבים

amodb מוכר מפתחות ל-API שלו, ששומר על הנתיבים ועל ה-JSON של TMDB v3. זה לא מפתח של TMDB והוא לא עובד ב-api.themoviedb.org. מה שמקבלים הוא מפתח באותה צורה, 32 תווים הקסדצימליים באותיות קטנות, שהלקוח שלכם ל-TMDB מקבל אחרי החלפה אחת של כתובת הבסיס.

1. פתחו את [עמוד התמחור](https://amodb.dev/he/pricing/) ובחרו מסלול: 20, 40 או 120 בקשות לדקה. כל מסלול מחזיר את כל הנתונים.
2. היכנסו עם האימייל שלכם. amodb שולח קוד בן 6 ספרות שתקף ל-10 דקות. אין סיסמה.
3. שלמו בכרטיס, ב-Apple Pay או ב-Google Pay עבור 1 עד 24 חודשים. שום דבר לא מתחדש אוטומטית.
4. פתחו **חשבון**, ואז **מפתחות API**, וצרו מפתח. העתיקו אותו מיד, כי המפתח המלא מוצג פעם אחת.

השלבים לוקחים בערך דקה, והמפתח עובד ברגע שהתשלום מאושר.

## שימוש במפתח: מחליפים את כתובת הבסיס

משאירים את הקוד שלכם ל-TMDB ומחליפים שני ערכים, את כתובת הבסיס ואת המפתח. שתי דרכי השליחה של המפתח עובדות, `api_key` בשאילתה וכותרת `Authorization: Bearer`.

```bash
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"
```

אותה קריאה עם כותרת Bearer, בשלוש שפות:

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

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
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,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])
```

התגובה בנויה כמו ב-TMDB v3:

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

קראו את `images.secure_base_url` מתוך `/3/configuration` כדי שקישורי הפוסטרים יצביעו ל-`img.amodb.dev`. תמונות לא צריכות מפתח. עוד על שליחת המפתח בעמוד [אימות](https://amodb.dev/he/authentication/), וסקירה ארוכה יותר ב[מדריך למתחילים](https://amodb.dev/he/quickstart/).

## מפתח TMDB חינמי ומפתח amodb זה לצד זה

הבחירה הנכונה תלויה בפרויקט ובתנאים שלכם, לא ברשימת תכונות. העמודה של TMDB רק חוזרת על מה ש-TMDB מפרסם באופן כללי. את הכללים העדכניים קראו בתנאים ובתיעוד של TMDB עצמו.

|             | מפתח TMDB חינמי                              | מפתח amodb                                                                                                    |
| ----------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| מחיר        | חינם לשימוש מתאים לפי התנאים של TMDB         | בתשלום, מראש ל-1 עד 24 חודשים, בלי תקופת ניסיון                                                               |
| איך מקבלים  | חשבון TMDB ובקשת מפתח באתר של TMDB           | אימייל, קוד בן 6 ספרות, תשלום, ואז יוצרים את המפתח בחשבון                                                     |
| שימוש מסחרי | את התנאים לשימוש מסחרי ולייחוס בדקו אצל TMDB | מותר לפי התנאים של amodb                                                                                      |
| מגבלת קצב   | נקבעת על ידי TMDB, ראו במסמכים שלהם          | 20, 40 או 120 בקשות לדקה לפי מסלול                                                                            |
| נתונים      | נתוני TMDB                                   | בצורה של TMDB v3, בתוספת `ratings`, `moods`, `soundtracks`, `wikidata` ו-`showtimes` דרך `append_to_response` |
| פורמט המפתח | מפתח v3, 32 תווים הקסדצימליים                | 32 תווים הקסדצימליים באותיות קטנות                                                                            |
| כתובת בסיס  | `https://api.themoviedb.org/3`               | `https://api.amodb.dev/3`                                                                                     |
| שיטות כתיבה | שיטות חשבון, רשימות ודירוג                   | לא מוצעות, מחזירות 405                                                                                        |

## מתי מפתח TMDB חינמי מספיק

הישארו עם מפתח TMDB חינמי לפרויקט אישי או לימודי שמתאים לתנאים של TMDB. אם השימוש שלכם מתאים, TMDB לא עולה כלום ו-amodb לא יכול להתחרות בזה.

השתמשו במפתח amodb כשהפרויקט מסחרי ואתם רוצים הסכם בתשלום, כשצריך מגבלה קבועה לדקה שאפשר לתכנן סביבה, או כשעמוד כותר אחד צריך לקבל דירוגים מחמישה מקורות בקריאה אחת. בדקו קודם את הפערים: שיטות כתיבה, פידים של שינויים וכמה נתיבים נוספים אינם מוצעים. הם רשומים בעמוד [חלופה ל-TMDB API](https://amodb.dev/he/tmdb-api-alternative/) וב[amodb מול TMDB](https://amodb.dev/he/amodb-vs-tmdb/).

## שימוש מסחרי ומגבלות

שימוש מסחרי מותר לפי [תנאי השימוש](https://amodb.dev/he/terms/) של amodb. מותר להציג את הנתונים באפליקציות, באתרים, בבוטים ובכלים פנימיים, ולשמור תגובות במטמון כדי לחסוך בקשות. אסור למכור מחדש גישה גולמית ל-API, לפרסם העתקים המוניים של תגובות ה-API, לשתף מפתחות או לפתוח חשבונות נוספים כדי להעלות את הקצב. הרשימה המלאה נמצאת ב[מדיניות השימוש ההוגן](https://amodb.dev/he/acceptable-use/).

המסלול קובע את הקצב. כל תגובה נושאת את `X-RateLimit-Limit`, את `X-RateLimit-Remaining` ואת `X-RateLimit-Reset`, ו-429 מוסיף `Retry-After`. פרטים בעמוד [מגבלות קצב](https://amodb.dev/he/rate-limits/).

## שאלות ותשובות

### האם זה מפתח API של TMDB?

לא. זה מפתח של amodb. יש לו אותה צורה כמו למפתח TMDB v3, 32 תווים הקסדצימליים באותיות קטנות, והוא עובד בנתיבים של amodb התואמים ל-TMDB v3 בכתובת https://api.amodb.dev/3. הוא לא עובד ב-api.themoviedb.org, ו-amodb הוא שירות עצמאי.

### אפשר לקבל מפתח API של TMDB בחינם?

TMDB מציע מפתח חינמי לשימוש מתאים לפי התנאים שלו, ומבקשים אותו באתר של TMDB. ל-amodb אין מסלול חינמי ואין תקופת ניסיון, ולכן מפתח amodb תמיד מגיע עם מסלול בתשלום. קראו את התנאים של TMDB לפני שמחליטים מה מתאים לכם.

### אפשר לקבל מפתח API של TMDB בלי הרשמה?

לא ב-amodb. נכנסים עם אימייל וקוד בן 6 ספרות, בלי סיסמה ובלי טופס בקשה, ואז משלמים ויוצרים את המפתח. מפתח TMDB דורש חשבון TMDB, ולכן את השלבים העדכניים בדקו באתר של TMDB.

### אפשר להשתמש במפתח בפרויקט מסחרי?

כן. שימוש מסחרי מותר לפי התנאים של amodb. אפשר להשתמש בנתונים באפליקציות ובאתרים שלכם, אבל אין למכור מחדש גישה גולמית ל-API, לשתף את המפתח או לשים אותו בקוד שרץ בצד הלקוח.

### כמה בקשות מפתח אחד יכול לבצע?

המסלול קובע את הקצב: 20, 40 או 120 בקשות לדקה לכל מפתח, בחלון נע של 60 שניות. כל מסלול מחזיר את כל הנתונים ואין תקרה יומית.

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

- [חלופה ל-TMDB API](https://amodb.dev/he/tmdb-api-alternative/): מחפשים חלופה ל-TMDB API? בדקו תנאים, מגבלות, שפות ודירוגים, ועברו ל-API בתשלום ששומר את רוב נתיבי הקריאה וה-JSON של TMDB v3. ראו את הפערים לפני המעבר.
- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.
- [תמחור](https://amodb.dev/he/pricing/): המסלולים של amodb נבדלים רק בבקשות לדקה: 20, 40 או 120. כל מסלול כולל את כל הנתונים התואמים ל-TMDB v3 ול-OMDb. תשלום מראש, בלי חידוש ובלי ניסיון.
- [אימות](https://amodb.dev/he/authentication/): איך שולחים את מפתח amodb: api_key בשאילתה, כותרת Authorization Bearer או apikey בקריאות OMDb. פורמט המפתח, שמירה, החלפה ושגיאות 401 שכדאי להכיר.
- [amodb מול TMDB](https://amodb.dev/he/amodb-vs-tmdb/): השוואה ישירה בין amodb ל-TMDB: התאמת נקודות קצה ו-JSON, הנתיבים ש-amodb לא מציע, תנאים חינמיים מול בתשלום, 14 שפות, חמש הרחבות ומגבלות קצב לכל מפתח.
- [מגבלות קצב](https://amodb.dev/he/rate-limits/): amodb מגביל כל מפתח לפי בקשות לדקה בחלון נע של 60 שניות: 20, 40 או 120 בהתאם למסלול שלכם. קראו את כותרות מגבלת הקצב וטפלו ב-429 עם Retry-After.

עודכן: 2026-10-19. Source: https://amodb.dev/he/tmdb-api-key/