# חלופה ל-Trakt API

> Trakt מתמקד בנתוני משתמש: היסטוריית צפייה, רשימות מעקב, דירוגים, לוחות שידורים ו-OAuth. amodb לא שומר פעילות משתמשים. זהו API בתשלום למטא-נתונים של סרטים, סדרות, אנשים, תמונות ודירוגים. אפליקציות רבות משתמשות בשניהם: מצב המשתמש נשמר ב-Trakt או במסד נתונים משלכם, ונתוני הכותרים נקראים מ-amodb.

## תפקידים שונים, כלים שונים

Trakt מתמקד בנתוני משתמש: היסטוריית צפייה, רשימות מעקב, דירוגים, לוחות שידורים והתחברות עם OAuth. יש לו גם נקודות קצה ציבוריות למטא-נתונים, והמסמכים שלו מציינים את המגבלות החלות. ל-amodb יש תפקיד אחד: מטא-נתונים של סרטים, סדרות ואנשים, שמוחזרים כ-JSON במבנה של TMDB v3. בחרו ב-Trakt למה שהמשתמשים שלכם עשו. בחרו ב-amodb למה שהכותר הוא. רוב האפליקציות שצריכות את שניהם קוראות לכל שירות עבור החלק שלו.

## נתוני משתמש מול נתוני כותרים

| משימה                | Trakt                                            | amodb                                                  |
| -------------------- | ------------------------------------------------ | ------------------------------------------------------ |
| היסטוריית צפייה      | יכולת מרכזית                                     | לא קיים, שמרו בעצמכם                                   |
| רשימות מעקב ורשימות  | יכולת מרכזית                                     | לא קיים, בקשות כתיבה מחזירות 405                       |
| דירוגי משתמשים       | יכולת מרכזית                                     | לא קיים, בקשות כתיבה מחזירות 405                       |
| לוחות שידורים        | לכל משתמש, ראו במסמכים שלהם                      | `next_episode_to_air` לכל סדרה ורשימות לפי לוח שידורים |
| התחברות              | OAuth                                            | מפתח בלבד, בלי התחברות משתמשים                         |
| מטא-נתונים של כותרים | נקודות קצה ציבוריות, את המגבלות ראו במסמכים שלהם | נקודות קצה לפרטים ב-14 שפות                            |
| שחקנים וצוות         | ראו במסמכים שלהם                                 | `/credits` לכותר, `combined_credits` לאדם              |
| תמונות               | ראו במסמכים שלהם                                 | `img.amodb.dev`, בלי מפתח                              |
| טריילרים             | ראו במסמכים שלהם                                 | `/videos` עם `type` ו-`official`                       |
| שינויים מאז תאריך    | ראו במסמכים שלהם                                 | לא קיים, אין פידים של שינויים                          |

לקבלת לוחות שידורים, `GET /3/tv/airing_today` ו-`GET /3/tv/on_the_air` מציגים סדרות לפי תאריך שידור, ולכל רשומת סדרה יש `next_episode_to_air` משלה. עבור סדרה שהסתיימה השדה הזה הוא `null`. שתי הרשימות מתוארות בעמוד [טרנדים ורשימות](https://amodb.dev/he/trending-lists/). את לוח השידורים של משתמש אחד מרכיבים מרשומות הצפייה שלכם.

## השוואת תכונות

| תכונה       | Trakt                                                 | amodb                                                                     |
| ----------- | ----------------------------------------------------- | ------------------------------------------------------------------------- |
| מודל תמחור  | ראו במסמכים שלהם                                      | תקופות בתשלום מראש של 1 עד 24 חודשים                                      |
| מסלול חינמי | ראו במסמכים שלהם                                      | אין, וגם אין תקופת ניסיון                                                 |
| אימות       | OAuth לנתוני משתמש, לקריאות ציבוריות ראו במסמכים שלהם | `api_key` או כותרת Bearer                                                 |
| פורמט תגובה | JSON, ראו במסמכים שלהם                                | JSON במבנה של TMDB v3                                                     |
| שפות        | ראו במסמכים שלהם                                      | 14 שפות ממשק                                                              |
| סרטים       | כן                                                    | כן                                                                        |
| סדרות       | כן                                                    | כן, עם עונות ופרקים                                                       |
| אנשים       | ראו במסמכים שלהם                                      | כן                                                                        |
| תמונות      | ראו במסמכים שלהם                                      | `img.amodb.dev`, אותם מזהי גודל כמו ב-TMDB                                |
| דירוגים     | דירוגי משתמשים, ראו במסמכים שלהם                      | ציונים מ-IMDb, Kinopoisk, Metacritic, Rotten Tomatoes ומ-TMDB כשהם ידועים |
| מגבלת קצב   | את המגבלות ראו במסמכים שלהם                           | 20, 40 או 120 לדקה לכל מפתח                                               |
| שימוש מסחרי | ראו במסמכים שלהם                                      | מסלולים בתשלום, ראו [תמחור](https://amodb.dev/he/pricing/)                |
| תאימות      | ה-API שלו                                             | קריאות של TMDB v3 ו-OMDb                                                  |

## במה amodb שונה

- **בלי מסך התחברות למשתמשים שלכם.** מפתח בצד השרת מספיק. אף אחד לא מחבר חשבון, ולכן אין אסימון לרענון ואין מסך הסכמה להסביר.
- **מגוון שדות רחב.** משך, ז'אנרים, חברות הפקה, דירוגי גיל, תרגומים ומילות מפתח מגיעים כולם מנקודות הקצה של הפרטים, בשפה שביקשתם.
- **מגבלות מפורסמות.** מגבלת המסלול היא מספר לדקה, וכל תגובה מציגה כמה נשאר. מהמספרים האלה אפשר לתכנן סנכרון ברקע.
- **מדדי מצב רוח ופסקולים.** ההרחבות בעמודים [מדדי מצב רוח](https://amodb.dev/he/moods/) ו[פסקולים](https://amodb.dev/he/soundtracks/) מוסיפות נתונים שאינם חלק מ-TMDB v3.

## מתי Trakt מתאים יותר

- **כל מה שאישי.** סקרובלינג (scrobbling), סנכרון היסטוריה, רשימות חברתיות ולוחות שידורים לכל משתמש הם יכולות של Trakt. ל-amodb אין חשבונות ואין שיטות כתיבה.
- **מצב בין מכשירים.** אם משתמש מצפה לראות את אותם סימוני צפייה בטלפון ובטלוויזיה, המצב חייב לחיות בשירות משתמשים, ו-amodb אינו כזה.
- **אפליקציות OAuth קיימות.** אם האפליקציה שלכם כבר מחזיקה אסימונים של Trakt, המשיכו להשתמש בהם. הוסיפו את amodb רק עבור נתוני הכותרים שאתם מביאים כיום ממקום אחר.

## מעבר ל-amodb: חיבור הרשומות שלכם

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

```php
<?php
declare(strict_types=1);

function amodb(string $path): array
{
    $ch = curl_init('https://api.amodb.dev/3' . $path);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => 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");
    }
    return json_decode($body, true);
}

$show = amodb('/tv/1396?language=en-US');
$next = $show['next_episode_to_air'] ?? null;
echo $show['name'], ' ', $show['status'], PHP_EOL;
echo $next ? 'Next: ' . $next['air_date'] : 'No episode scheduled', PHP_EOL;
```

כשיש לכם רק מזהה IMDb, קראו פעם אחת ל-`/3/find/tt0903747?external_source=imdb_id` ושמרו את המזהה מתוך `tv_results`. תגובת 429 כוללת `Retry-After`, כמתואר בעמוד [מגבלות קצב](https://amodb.dev/he/rate-limits/).

## תכנון משימת רענון

ספריית משתמש של 200 סדרות דורשת 200 בקשות פרטים כדי לרענן פעם אחת. ב-20 בקשות לדקה זה לוקח 10 דקות, ב-40 זה לוקח 5, וב-120 זה לוקח פחות מ-2. בדיקת המפתח רצה לפני מטמון הקצה, ולכן גם קריאות חוזרות נספרות. ל-amodb אין פידים של שינויים, ולכן הוא לא יכול לומר אילו מזהים השתנו מאז תאריך מסוים. במקום זאת קראו את `status` ואת `next_episode_to_air` מתגובת הפרטים. רעננו לעיתים קרובות סדרות שעדיין משודרות, ורעננו לעיתים רחוקות סדרות שהסתיימו. הפרטים נשמרים במטמון 6 שעות, ולכן רענון תכוף יותר מכך מחזיר את אותם נתונים.

## תמחור

amodb הוא בתשלום מראש ואינו מתחדש מעצמו. בחרו 1, 3, 6, 12 או 24 חודשים, שמקנים 0, 10, 20, 30 או 40 אחוז הנחה, ואחד משלושה מסלולים של 20, 40 או 120 בקשות לדקה. כל מסלול מחזיר את כל הנתונים ואין מסלול חינמי. הסכומים מופיעים בעמוד [תמחור](https://amodb.dev/he/pricing/).

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

### האם amodb יכול להחליף את היסטוריית הצפייה ורשימות המעקב של Trakt?

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

### האם צריך OAuth כדי לקרוא ל-amodb?

לא. כל בקשה נושאת את המפתח שלכם בפרמטר השאילתה api_key או בכותרת Authorization Bearer. אין תהליך התחברות של משתמשים, כי ה-API מגיש מטא-נתונים ולא מידע אישי.

### איך מצמידים רשומות של Trakt לכותרים של amodb?

פריטי Trakt מציינים מזהים של מאגרים אחרים, כמו IMDb ו-TMDB (את השדות המדויקים ראו במסמכים שלהם). מזהה TMDB עובד ישירות ב-amodb, ומזהה IMDb נפתר דרך /3/find עם external_source=imdb_id.

### האם יש לוח שנה של פרקים קרובים?

פרטי הסדרה מחזירים next_episode_to_air לכל סדרה שאתם עוקבים אחריה, ו-/tv/airing_today ו-/tv/on_the_air מציגים סדרות לפי לוח השידורים. amodb לא בונה לוח שנה למשתמש מסוים.

### מה מגבלות הקצב בהשוואה ל-Trakt?

את מגבלות Trakt בנקודות הקצה הציבוריות של המטא-נתונים ראו במסמכים שלהם. amodb מאפשר 20, 40 או 120 בקשות לדקה לכל מפתח, לפי המסלול, ומציג את הכמות שנותרה בכותרות התגובה.

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

- [API לסדרות טלוויזיה, עונות ופרקים](https://amodb.dev/he/tv-show-api/): API לסדרות טלוויזיה עם סטטוס, רשתות, עונות, פרקים, תאריכי שידור ו-next_episode_to_air. JSON תואם TMDB v3 ב-14 שפות, במסלולים של 20 עד 120 בקשות לדקה.
- [API סדרות טלוויזיה](https://amodb.dev/he/tv-series/): API סדרות טלוויזיה עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סדרה לפי מזהה ב-GET /3/tv/{series_id} עם עונות, רשתות והפרק הבא, וגם סיווגי גיל וספקי צפייה.
- [חיפוש לפי מזהה חיצוני](https://amodb.dev/he/find-by-external-id/): חפשו סרט, סדרה או אדם לפי מזהה IMDb, TVDB, Wikidata או Kinopoisk עם נקודת הקצה find של TMDB v3, וקראו מזהים חיצוניים ועובדות Wikidata על כל כותר.
- [נקודות קצה של מגמות ורשימות](https://amodb.dev/he/trending-lists/): API סרטים פופולריים עם נתיבי TMDB v3: טבלאות יומיות ושבועיות, ורשימות מוקרנים עכשיו, פופולריים, מדורגים וצפויים לסרטים ולסדרות, במטמון 30 דקות.
- [אימות](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/trakt-api-alternative/