# התיעוד של amodb

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

## כתובות בסיס

| שימוש          | כתובת בסיס                                | פרמטר המפתח                          |
| -------------- | ----------------------------------------- | ------------------------------------ |
| בסגנון TMDB v3 | `https://api.amodb.dev/3`                 | `api_key` או `Authorization: Bearer` |
| בסגנון OMDb    | `https://api.amodb.dev/omdb/`             | `apikey`                             |
| תמונות         | `https://img.amodb.dev/t/p/{size}/{file}` | אין                                  |
| קטלוג מסלולים  | `https://api.amodb.dev/plans`             | אין                                  |

### תחילת העבודה

- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.
- [אימות](https://amodb.dev/he/authentication/): איך שולחים את מפתח amodb: api_key בשאילתה, כותרת Authorization Bearer או apikey בקריאות OMDb. פורמט המפתח, שמירה, החלפה ושגיאות 401 שכדאי להכיר.

### מושגים

- [מגבלות קצב](https://amodb.dev/he/rate-limits/): amodb מגביל כל מפתח לפי בקשות לדקה בחלון נע של 60 שניות: 20, 40 או 120 בהתאם למסלול שלכם. קראו את כותרות מגבלת הקצב וטפלו ב-429 עם Retry-After.
- [שגיאות](https://amodb.dev/he/errors/): כל שגיאה של amodb עם סטטוס HTTP, status_code והודעה של TMDB, וגם מבנה השגיאה של OMDb. מה כל אחת מהן אומרת ומה הלקוח שלכם צריך לעשות כשהיא מופיעה.
- [שפות](https://amodb.dev/he/languages/): amodb מגיש כותרים, תקצירים ושמות ב-14 שפות. העבירו בפרמטר language תגית בסגנון TMDB כמו ru-RU או pt-BR; כל תגית אחרת חוזרת לאנגלית, בלי שגיאה.
- [תמונות](https://amodb.dev/he/images/): טענו פוסטרים, תמונות רקע ותמונות פרופיל מ-img.amodb.dev עם נתיבים וגדלים של TMDB מ-w92 ועד original. בלי מפתח, מטמון ל-30 יום ותבנית כתובת אחת לכולן.

### מדריך עזר ל-API

- [API פרטי סרט](https://amodb.dev/he/movies/): API פרטי סרט עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סרט לפי מזהה, הוסיפו קרדיטים, דירוגים, מצבי רוח ופסקולים עם append_to_response, ב-14 שפות.
- [API סדרות טלוויזיה](https://amodb.dev/he/tv-series/): API סדרות טלוויזיה עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סדרה לפי מזהה ב-GET /3/tv/{series_id} עם עונות, רשתות והפרק הבא, וגם סיווגי גיל וספקי צפייה.
- [API עונות ופרקים של סדרות](https://amodb.dev/he/tv-seasons-episodes/): API עונות ופרקים של סדרות עם אותם נתיבים ו-JSON כמו TMDB v3. קראו עונה עם כל הפרקים שלה, או פרק אחד עם תאריך שידור, משך ותמונה מהפרק, עם crew ו-guest_stars.
- [API פרטי אדם](https://amodb.dev/he/people/): API פרטי אדם עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו שחקן או איש צוות לפי מזהה, עם ביוגרפיה, פילמוגרפיה, מזהים חיצוניים, תמונות פרופיל והרשימה הפופולרית.
- [API קרדיטים](https://amodb.dev/he/credits/): API קרדיטים עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו שחקנים וצוות של סרטים, סדרות, עונות ופרקים, עם credit_id, order, department ו-job ועם guest_stars בפרקים.
- [API חיפוש](https://amodb.dev/he/search/): API חיפוש עם אותם נתיבים ו-JSON כמו TMDB v3. מצאו סרטים, סדרות, אנשים, אוספים, חברות ומילות מפתח לפי טקסט, עם סינון לפי שנה ועימוד של 20 תוצאות בעמוד.
- [API גילוי](https://amodb.dev/he/discover/): Discover API עם אותם מסננים כמו TMDB v3. הציגו סרטים וסדרות לפי ז'אנר, שחקנים, חברה, מילת מפתח, שנה, דירוג, משך וספק סטרימינג, עם מיון ודפדוף בתוצאות.
- [נקודות קצה של מגמות ורשימות](https://amodb.dev/he/trending-lists/): API סרטים פופולריים עם נתיבי TMDB v3: טבלאות יומיות ושבועיות, ורשימות מוקרנים עכשיו, פופולריים, מדורגים וצפויים לסרטים ולסדרות, במטמון 30 דקות.
- [ז'אנרים ורשימות חיפוש](https://amodb.dev/he/genres/): API ז'אנרים עם נתיבי TMDB v3: מזהי ז'אנרים של סרטים וסדרות עם שמות מתורגמים, ובנוסף רשימות של מדינות, שפות, תפקידים, דירוגי גיל וספקי סטרימינג.
- [API תמונות ושרת תמונות](https://amodb.dev/he/images-api/): API תמונות סרטים עם נתיבי TMDB v3: הציגו פוסטרים, תמונות רקע, לוגואים ותמונות סצנה לכל כותר, וטענו אותם מ-img.amodb.dev ב-10 גדלים בלי מפתח.
- [API סרטונים וטריילרים](https://amodb.dev/he/videos-trailers/): API סרטונים עם נתיבי TMDB v3, כמו GET /3/movie/{movie_id}/videos: רשימת טריילרים, טיזרים, קטעים ופיצ'רטים של סרט או סדרה, ואז סינון לפי סוג ושפה בקוד שלכם.
- [API תרגומים](https://amodb.dev/he/translations/): API תרגומים עם נתיבי TMDB v3: קראו בבת אחת את כל הכותרות, התקצירים והסלוגנים שנשמרו לסרט, לסדרה או לפרק, בכל השפות שלהם, עם iso_639_1 ו-english_name.
- [API מילות מפתח](https://amodb.dev/he/keywords/): API מילות מפתח עם נתיבי TMDB v3: הציגו תגיות עלילה של סרט או סדרה, חפשו מילת מפתח, הציגו את הסרטים שלה ושלבו מזהים עם with_keywords ב-discover.
- [API לאוספים](https://amodb.dev/he/collections/): API אוספי סרטים עם נתיבי TMDB v3: שלפו זיכיון ב-GET /3/collection/{collection_id} עם מערך parts, קראו את belongs_to_collection בסרט וחפשו אוספים לפי שם.
- [חברות ורשתות שידור](https://amodb.dev/he/companies-networks/): חפשו חברות הפקה ורשתות טלוויזיה עם נתיבי TMDB v3. קראו שם, מדינת מקור ולוגו לפי מזהה, ואז סננו את discover באמצעות with_companies או with_networks.
- [דירוגי סרטים וסדרות](https://amodb.dev/he/ratings/): API דירוגי סרטים וסדרות שמחזיר ציוני IMDb, Kinopoisk, Metacritic, Rotten Tomatoes ו-TMDB לכותר בקריאה אחת, עם value ו-votes ו-null לכל מקור שאינו ידוע.
- [חיפוש לפי מזהה חיצוני](https://amodb.dev/he/find-by-external-id/): חפשו סרט, סדרה או אדם לפי מזהה IMDb, TVDB, Wikidata או Kinopoisk עם נקודת הקצה find של TMDB v3, וקראו מזהים חיצוניים ועובדות Wikidata על כל כותר.
- [נקודת קצה תואמת OMDb](https://amodb.dev/he/omdb-endpoint/): נקודת קצה תואמת OMDb API בכתובת api.amodb.dev/omdb/. חפשו לפי i או t, חפשו עם s, קראו את המערך Ratings ושמרו את הלקוח שלכם בהחלפת כתובת הבסיס.
- [מדדי מצב רוח](https://amodb.dev/he/moods/): API מצב רוח בסרטים עם מדדים בסולם 0 עד 10 לכל כותר. קראו מצבי רוח של סרט או סדרה, מזגו אותם עם append_to_response=moods ובנו תגים או מסננים.
- [פסקולים](https://amodb.dev/he/soundtracks/): API פסקולים שמחזיר את אלבום הפסקול של סרט או סדרה עם רשימת הרצועות שלו. קראו ל-GET /3/movie/{movie_id}/soundtracks או הוסיפו append_to_response=soundtracks.
- [זמני הקרנות בקולנוע](https://amodb.dev/he/showtimes/): API זמני הקרנות שמחזיר בתי קולנוע וזמני הקרנה של סרט במדינה אחת לפי הפרמטר country, או סיכום לפי מדינה. מזגו אותו לפרטים או שלבו אותו עם now_playing.

### משאבים

- [יומן שינויים](https://amodb.dev/he/changelog/): רשימה מתוארכת של שינויים ב-API של amodb, במארח התמונות img.amodb.dev, במסלולים ובאתר. רשומות חדשות בראש הרשימה, עם מה שהשתנה ומה שאתם צריכים לעשות.

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

- [מדריך עזר ל-API](https://amodb.dev/he/reference/): כל נקודת קצה של amodb עם הנתיב, הפרמטרים, דוגמאות בקשה בחמש שפות תכנות ותגובת JSON אמיתית. הנתיבים תואמים ל-TMDB v3 ול-OMDb ומשתמשים באותו מפתח.

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

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

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

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

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

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