# API לאוספים > אוסף מקבץ את הסרטים של זיכיון אחד, כמו טרילוגיה או סדרת סרטים ארוכה. GET /3/collection/{collection_id} מחזיר את השם, התקציר, הגרפיקה ומערך parts של סרטים לפי סדר יציאה. סרטים מצביעים חזרה על האוסף שלהם דרך belongs_to_collection, ולכן אפשר לנוע בשני הכיוונים. ## נקודת קצה `GET /3/collection/{collection_id}` ```bash curl "https://api.amodb.dev/3/collection/10?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` תגובה: ```json { "id": 10, "name": "Star Wars - Saga", "overview": "An epic space-opera theatrical film series, which depicts the adventures of various characters \"a long time ago in a galaxy far, far away….\"", "poster_path": "/6mHkagjziBPth2Mx0VpEercocm4.jpg", "backdrop_path": "/iY2ujEY2m68OTTlPFTiHub9joHS.jpg", "parts": [ { "adult": false, "backdrop_path": "/jKquaxnCRelAbibZVMdTsUEnkKm.jpg", "genre_ids": [ 12, 28, 878 ], "id": 11, "original_language": "en", "original_title": "Star Wars", "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to re...", "popularity": 70.481, "poster_path": "/fai0rspsNeJCS69wHNjOdWxcI7P.jpg", "release_date": "1977-05-25", "title": "Star Wars", "video": false, "vote_average": 8.207, "vote_count": 23028, "media_type": "movie" }, { "adult": false, "backdrop_path": "/k9pshruhCpJAdH9RaGJO6jaWQ4X.jpg", "genre_ids": [ 12, 28, 878 ], "id": 1891, "original_language": "en", "original_title": "The Empire Strikes Back", "overview": "The epic saga continues as Luke Skywalker, in hopes of defeating the evil Galactic Empire, learns the ways of the Jedi from aging master Yoda. But Darth Vader is more determined than ever to capture Luke. Meanwhile, rebel leader Princess Le...", "popularity": 29.9034, "poster_path": "/nNAeTmF4CtdSgMDplXTDPOpYzsX.jpg", "release_date": "1980-05-20", "title": "The Empire Strikes Back", "video": false, "vote_average": 8.393, "vote_count": 18993, "media_type": "movie" }, { "adult": false, "backdrop_path": "/ziECpBRIyclmBNaFSWlvCfsKbMD.jpg", "genre_ids": [ 12, 28, 878 ], "id": 1892, "original_language": "en", "original_title": "Return of the Jedi", "overview": "Luke Skywalker leads a mission to rescue his friend Han Solo from the clutches of Jabba the Hutt, the Emperor prepares to crush the Rebellion with a more powerful Death Star, and the Rebel fleet mounts a massive attack on the space station....", "popularity": 26.3255, "poster_path": "/jQYlydvHm3kUix1f8prMucrplhm.jpg", "release_date": "1983-05-25", "title": "Return of the Jedi", "video": false, "vote_average": 7.911, "vote_count": 17442, "media_type": "movie" } ] } ``` ## קבלת אוסף `GET /3/collection/{collection_id}` מחזיר זיכיון אחד: את השם שלו, תקציר, פוסטר, תמונת רקע ואת המערך `parts`. כל חלק הוא סיכום של סרט עם השדות הדרושים לכרטיס, ולכן קריאה אחת יכולה לצייר מדף שלם של זיכיון. הדוגמה טוענת את אוסף 10, סרטי מלחמת הכוכבים, ומדפיסה את הסרטים שלו לפי סדר יציאה. ```bash curl -s "https://api.amodb.dev/3/collection/10?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```js const url = 'https://api.amodb.dev/3/collection/10?language=en-US'; const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` } }); if (!res.ok) throw new Error(`amodb returned ${res.status}`); const collection = await res.json(); console.log(collection.name); for (const p of collection.parts) console.log(p.release_date || 'not dated', p.title); ``` ```python import os import requests r = requests.get( "https://api.amodb.dev/3/collection/10", params={"language": "en-US"}, headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"}, timeout=10, ) r.raise_for_status() collection = r.json() print(collection["name"]) for p in collection["parts"]: print(p.get("release_date") or "not dated", p["title"]) ``` ```php true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')], ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($status !== 200) { throw new RuntimeException("amodb returned $status"); } $collection = json_decode($body, true); echo $collection['name'], PHP_EOL; foreach ($collection['parts'] as $p) { echo $p['release_date'] ?: 'not dated', ' ', $p['title'], PHP_EOL; } ``` ```go package main import ( "encoding/json" "fmt" "net/http" "os" "time" ) type Collection struct { Name string `json:"name"` Parts []struct { Title string `json:"title"` ReleaseDate string `json:"release_date"` } `json:"parts"` } func main() { url := "https://api.amodb.dev/3/collection/10?language=en-US" req, _ := http.NewRequest("GET", url, nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY")) client := &http.Client{Timeout: 10 * time.Second} res, err := client.Do(req) if err != nil { panic(err) } defer res.Body.Close() if res.StatusCode != http.StatusOK { panic(res.Status) } var c Collection if err := json.NewDecoder(res.Body).Decode(&c); err != nil { panic(err) } fmt.Println(c.Name) for _, p := range c.Parts { date := p.ReleaseDate if date == "" { date = "not dated" } fmt.Println(date, p.Title) } } ``` ### פרמטרים | פרמטר | מיקום | חובה | תיאור | | --------------- | ------ | ---------- | ---------------------------------------------------------------------------------------------------------- | | `collection_id` | נתיב | כן | מזהה אוסף מספרי, למשל `10`. | | `api_key` | שאילתה | אחד משניים | המפתח שלכם. השתמשו בו או בכותרת `Authorization: Bearer`. | | `language` | שאילתה | לא | אחת מ-14 השפות המוגשות, למשל `en-US` או `fr-FR`. קובע את שפת הכותרת והתקציר של כל חלק. ברירת מחדל `en-US`. | ה-`name` וה-`overview` של האוסף עצמו מגיעים כפי שנשמרו ואינם משתנים לפי `language`. באוספים מסוימים הם לא באנגלית. ### שדות התגובה | שדה | סוג | הערות | | ---------------------------------------------- | --------------- | -------------------------------------------------------------------------------------------- | | `id` | integer | מזהה האוסף. | | `name` | string | שם הזיכיון. | | `overview` | string | תיאור קצר. ריק בחלק מהאוספים. | | `poster_path`, `backdrop_path` | string או null | מצרפים ל-`https://img.amodb.dev/t/p/{size}`. ראו [תמונות](https://amodb.dev/he/images-api/). | | `parts` | array | סיכומי סרטים, `release_date` הישן ביותר ראשון. | | `parts[].id` | integer | מזהה הסרט. העבירו אותו אל [פרטי סרט](https://amodb.dev/he/movies/). | | `parts[].title`, `parts[].original_title` | string | כותרת מתורגמת וכותרת מקורית. | | `parts[].overview` | string | תקציר מתורגם. | | `parts[].release_date` | string | `YYYY-MM-DD`, או מחרוזת ריקה לסרט בלי תאריך. חלקים כאלה מופיעים אחרונים. | | `parts[].media_type` | string | תמיד `movie` באוסף. | | `parts[].genre_ids` | array | מזהים מספריים. השמות מגיעים מעמוד [ז'אנרים](https://amodb.dev/he/genres/). | | `parts[].adult`, `parts[].video` | boolean | `adult` הוא תמיד `false`, כי כותרים למבוגרים לא מוגשים. | | `parts[].original_language` | string | קוד שפה בן שתי אותיות. | | `parts[].popularity` | number | ציון פופולריות. | | `parts[].poster_path`, `parts[].backdrop_path` | string או null | הגרפיקה של הסרט. | | `parts[].vote_average`, `parts[].vote_count` | number, integer | ציון משתמשים מצטבר. | ### תגובה לדוגמה מוצגים שניים מתוך תשעת החלקים. ```json { "id": 10, "name": "Star Wars Collection", "overview": "An epic space-opera theatrical film series, which depicts the adventures of various cha...", "poster_path": "/pWVLFh4OuejTpUaDQbB1C4zoS2p.jpg", "backdrop_path": "/iY2ujEY2m68OTTlPFTiHub9joHS.jpg", "parts": [ { "adult": false, "backdrop_path": "/zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg", "genre_ids": [12, 28, 878], "id": 11, "original_language": "en", "original_title": "Star Wars", "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort...", "popularity": 70.481, "poster_path": "/fai0rspsNeJCS69wHNjOdWxcI7P.jpg", "release_date": "1977-05-25", "title": "Star Wars", "video": false, "vote_average": 8.207, "vote_count": 23025, "media_type": "movie" }, { "adult": false, "backdrop_path": "/k9pshruhCpJAdH9RaGJO6jaWQ4X.jpg", "genre_ids": [12, 28, 878], "id": 1891, "original_language": "en", "original_title": "The Empire Strikes Back", "overview": "The epic saga continues as Luke Skywalker, in hopes of defeating the evil Galactic Empi...", "popularity": 29.9034, "poster_path": "/nNAeTmF4CtdSgMDplXTDPOpYzsX.jpg", "release_date": "1980-05-20", "title": "The Empire Strikes Back", "video": false, "vote_average": 8.393, "vote_count": 18990, "media_type": "movie" } ] } ``` מחרוזות ארוכות נחתכות עם `...` בעמוד הזה. התגובה האמיתית מכילה את הטקסט המלא. ## מציאת האוסף של סרט לעיתים רחוקות מתחילים ממזהה אוסף. מתחילים מסרט, ורשומת [פרטי הסרט](https://amodb.dev/he/movies/) אומרת לאן הוא שייך. השדה `belongs_to_collection` הוא אובייקט עם `id`, `name`, `poster_path` ו-`backdrop_path`. הוא `null` בסרט שאינו חלק מזיכיון, כמו סרט 550. ```json { "id": 11, "title": "Star Wars", "belongs_to_collection": { "id": 10, "name": "Star Wars Collection", "poster_path": "/pWVLFh4OuejTpUaDQbB1C4zoS2p.jpg", "backdrop_path": "/iY2ujEY2m68OTTlPFTiHub9joHS.jpg" } } ``` הדוגמה שלמטה עוקבת אחרי הקישור הזה מסרט אל הזיכיון שלו בשתי בקשות. ```js const base = 'https://api.amodb.dev/3'; const headers = { Authorization: `Bearer ${process.env.AMODB_KEY}` }; async function getJson(path) { const res = await fetch(`${base}${path}`, { headers }); if (!res.ok) throw new Error(`${path} returned ${res.status}`); return res.json(); } const movie = await getJson('/movie/11'); if (movie.belongs_to_collection) { const collection = await getJson(`/collection/${movie.belongs_to_collection.id}`); console.log(movie.title, 'is one of', collection.parts.length, 'films in', collection.name); } ``` ## גרפיקה וחיפוש הפוסטר ותמונת הרקע של זיכיון הם השדות `poster_path` ו-`backdrop_path` ברשומת האוסף. בנו מהם את כתובת הקובץ כמתואר בעמוד [תמונות](https://amodb.dev/he/images-api/). amodb לא מציע את הנתיבים `/collection/{collection_id}/images` ו-`/collection/{collection_id}/translations`, ולכן לאוסף אין רשימת פוסטרים חלופיים ואין שורות לפי שפה. במקום זה הכותרות של החלקים עוקבות אחרי הפרמטר `language`, והנתיבים שכן מחזירים שורות לפי שפה מכוסים בעמוד [תרגומים](https://amodb.dev/he/translations/). כדי למצוא אוסף לפי שם, השתמשו ב-`GET /3/search/collection?query=matrix`, שמתואר בעמוד [חיפוש](https://amodb.dev/he/search/). בכל תוצאה יש `id`, `name`, `overview`, `poster_path`, `backdrop_path`, `original_language`, `original_name` ו-`adult`. ## שגיאות | HTTP | status_code | מתי | | ---- | ----------- | ---------------------------------------------------- | | 401 | 7 | המפתח חסר או שגוי. | | 402 | 36 | תקופת המסלול הסתיימה. | | 404 | 34 | אין אוסף עם המזהה הזה, או שהמזהה אינו מספר. | | 405 | 37 | השתמשתם בשיטת כתיבה בנתיב של אוסף. | | 429 | 25 | חרגתם מהבקשות שלכם לדקה. המתינו `Retry-After` שניות. | את הרשימה המלאה ראו בעמוד [שגיאות](https://amodb.dev/he/errors/), ואת מגבלות המסלולים בעמוד [מגבלות קצב](https://amodb.dev/he/rate-limits/). ## הערות מעשיות - אוספים מקבצים סרטים בלבד. לסרט יש לכל היותר אובייקט `belongs_to_collection` אחד, ולכן סרט אחד ממופה לזיכיון אחד. - החלקים מגיעים לפי סדר יציאה. סרטים עם תאריך ריק מגיעים אחרונים, ולכן סמנו אותם כעדיין בלי תאריך. - רשומת האוסף נשמרת בקצה במטמון 6 שעות כמו פרטים אחרים, ולכן עמוד זיכיון יכול להשתמש שוב בתגובה אחת כל כך הרבה זמן. - חלק נושא רק שדות סיכום. שלפו משך, קרדיטים ודירוגים לכל סרט דרך [פרטי סרט](https://amodb.dev/he/movies/) כשהמשתמש פותח אותו. - השתמשו ב-`parts[].id` כמפתח של סרט, לא במיקום שלו בזיכיון. סדר ותאריכים מתוקנים עם הזמן. - בדקו ש-`name` בשפת התצוגה שלכם לפני שמציגים אותו. באוספים מסוימים השם בשפה אחרת, ו-`language` לא משנה אותו. ## שאלות ותשובות ### איך יודעים אם סרט שייך לאוסף? קראו את belongs_to_collection ברשומת פרטי הסרט. זה אובייקט עם id, name, poster_path ו-backdrop_path, או null כשהסרט עומד לבדו. השתמשו במזהה הזה בנתיב האוסף. ### האם החלקים מוחזרים לפי סדר יציאה? כן. המערך parts מסודר מהישן לחדש לפי release_date. סרט בלי תאריך מקבל release_date ריק ומוצב אחרון, ולכן סמנו אותו כעדיין בלי תאריך. ### האם לסדרות טלוויזיה יש אוספים? לא. אוספים מקבצים סרטים. סדרה מתוארת בעונות ובפרקים שלה, שמתועדים בעמודי סדרות הטלוויזיה והעונות והפרקים. ### איך מחפשים אוסף לפי שם? השתמשו בנתיב החיפוש של אוספים, למשל /3/search/collection?query=matrix. הוא מחזיר רשימה מדורגת עם מזהה, שם וגרפיקה. קחו את המזהה וקראו לנקודת הקצה של האוסף כדי לקבל את החלקים. ## עמודים קשורים - [API פרטי סרט](https://amodb.dev/he/movies/): API פרטי סרט עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סרט לפי מזהה, הוסיפו קרדיטים, דירוגים, מצבי רוח ופסקולים עם append_to_response, ב-14 שפות. - [API חיפוש](https://amodb.dev/he/search/): API חיפוש עם אותם נתיבים ו-JSON כמו TMDB v3. מצאו סרטים, סדרות, אנשים, אוספים, חברות ומילות מפתח לפי טקסט, עם סינון לפי שנה ועימוד של 20 תוצאות בעמוד. - [API תמונות ושרת תמונות](https://amodb.dev/he/images-api/): API תמונות סרטים עם נתיבי TMDB v3: הציגו פוסטרים, תמונות רקע, לוגואים ותמונות סצנה לכל כותר, וטענו אותם מ-img.amodb.dev ב-10 גדלים בלי מפתח. - [API תרגומים](https://amodb.dev/he/translations/): API תרגומים עם נתיבי TMDB v3: קראו בבת אחת את כל הכותרות, התקצירים והסלוגנים שנשמרו לסרט, לסדרה או לפרק, בכל השפות שלהם, עם iso_639_1 ו-english_name. - [API גילוי](https://amodb.dev/he/discover/): Discover API עם אותם מסננים כמו TMDB v3. הציגו סרטים וסדרות לפי ז'אנר, שחקנים, חברה, מילת מפתח, שנה, דירוג, משך וספק סטרימינג, עם מיון ודפדוף בתוצאות. - [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות. עודכן: 2026-10-18. Source: https://amodb.dev/he/collections/