# שגיאות

> קריאות בסגנון TMDB מחזירות שגיאות בגוף של TMDB: success עם הערך false, status_code מספרי ו-status_message. קריאות בסגנון OMDb מחזירות Response עם הערך False ומחרוזת Error. amodb משתמש ב-8 קודים של TMDB, מ-7 למפתח לא תקין ועד 25 למגבלת הקצב ו-36 למסלול שפג. כדאי לנסות שוב רק 429, 500 ו-504.

## גוף שגיאה בסגנון TMDB

כל שגיאה מ-`https://api.amodb.dev/3` היא בעלת אותו מבנה JSON כמו ב-TMDB:

```json
{
  "success": false,
  "status_code": 34,
  "status_message": "The resource you requested could not be found."
}
```

## קודי שגיאה

| HTTP | status_code | status_message                                                               | מה לעשות                                     |
| ---- | ----------- | ---------------------------------------------------------------------------- | -------------------------------------------- |
| 401  | 7           | Invalid API key: You must be granted a valid key.                            | בדקו את המפתח ואת האופן שבו אתם שולחים אותו. |
| 401  | 10          | Suspended API key: Access to your account has been suspended, contact amodb. | כתבו אל <support@amodb.dev>.                 |
| 402  | 36          | Your plan has expired. Renew at <https://amodb.dev/pricing>                  | שלמו עבור תקופה חדשה.                        |
| 404  | 34          | The resource you requested could not be found.                               | בדקו את המזהה או את הנתיב.                   |
| 405  | 37          | This method is not offered by amodb.                                         | השתמשו בנקודת קצה לקריאה.                    |
| 429  | 25          | Your request count (N) is over the allowed limit of (L).                     | המתינו `Retry-After` שניות.                  |
| 500  | 11          | Internal error: Something went wrong, contact amodb.                         | נסו שוב אחרי כמה שניות.                      |
| 504  | 24          | Your request to the backend server timed out. Try again.                     | נסו שוב אחרי כמה שניות.                      |

## גוף שגיאה בסגנון OMDb

נקודת הקצה התואמת ל-OMDb שומרת על המבנה ועל הניסוח של OMDb:

```json
{
  "Response": "False",
  "Error": "Movie not found!"
}
```

קריאת OMDb עם `r=xml` מחזירה HTTP 400. השתמשו ב-`r=json` או השמיטו את `r`.

## טיפול בשגיאות בקוד

```js
const res = await fetch("https://api.amodb.dev/3/movie/550", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) {
  const err = await res.json();
  if (res.status === 429) {
    // wait Retry-After seconds, then retry
  }
  throw new Error(`amodb ${res.status} code ${err.status_code}: ${err.status_message}`);
}
```

```python
res = requests.get(url, headers=headers, timeout=10)
if not res.ok:
    err = res.json()
    raise RuntimeError(f"amodb {res.status_code} code {err['status_code']}: {err['status_message']}")
```

## גיבויים שאינם שגיאות

- תגית `language` לא מוכרת לא נכשלת. amodb מגיש עבורה אנגלית.
- שדה בלי נתונים הוא `null` או מערך ריק, כמו ב-TMDB.

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

### אילו שגיאות הלקוח שלי צריך לנסות שוב?

נסו שוב 429 אחרי Retry-After שניות, ו-500 או 504 עם השהיה של כמה שניות. אל תנסו שוב 401, 402, 404 או 405: אותה קריאה תיכשל שוב.

### למה אני מקבל 405 בנקודת קצה של TMDB?

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

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

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

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