# אימות

> כל בקשה ל-amodb נושאת מפתח אחד: 32 תווים הקסדצימליים באותיות קטנות. שולחים אותו כ-api_key בשאילתה או ככותרת Authorization: Bearer בקריאות בסגנון TMDB, וכ-apikey בקריאות בסגנון OMDb. תמונות לא צריכות מפתח. מפתח שגוי מחזיר 401 עם status_code 7, ומפתח מושעה מחזיר 401 עם status_code 10.

## פורמט המפתח

מפתח הוא 32 תווים הקסדצימליים באותיות קטנות, למשל `0123456789abcdef0123456789abcdef`. יש לו אותה צורה כמו למפתח TMDB v3, ולכן שדות ומאמתים שנבנו למפתחות TMDB מקבלים אותו.

amodb שומר רק גיבוב SHA-256 של כל מפתח. המפתח המלא מוצג פעם אחת, ברגע היצירה. אם איבדתם אותו, מחקו אותו וצרו חדש.

## קריאות בסגנון TMDB

שלחו את המפתח באחת משתי דרכים. שתיהן עובדות בכל נקודת קצה תחת `https://api.amodb.dev/3`.

| שיטה         | דוגמה                            |
| ------------ | -------------------------------- |
| פרמטר שאילתה | `?api_key=YOUR_KEY`              |
| כותרת        | `Authorization: Bearer YOUR_KEY` |

```bash
curl "https://api.amodb.dev/3/configuration" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/configuration", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
```

```python
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/configuration",
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
```

```php
<?php
$url = "https://api.amodb.dev/3/configuration?api_key=" . urlencode(getenv("AMODB_KEY"));
$config = json_decode(file_get_contents($url), true);
```

```go
req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/configuration", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
res, err := http.DefaultClient.Do(req)
```

## קריאות בסגנון OMDb

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

```bash
curl "https://api.amodb.dev/omdb/?t=Inception&y=2010&apikey=$AMODB_KEY"
```

## תמונות לא צריכות מפתח

כתובות תמונות ב-`img.amodb.dev` פומביות. אל תוסיפו להן את המפתח: תג `<img>` יחשוף אותו לכל מבקר.

## שמרו מפתחות בצד השרת

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

- שמרו את המפתח במשתנה סביבה או במנהל סודות.
- השתמשו במפתח אחד לכל אפליקציה או סביבה, עם תווית כמו `production` או `staging`.
- מחקו מפתח ברגע שהוא דולף. קריאות איתו נכשלות מיד.

## שגיאות

| HTTP | status_code | משמעות                                                  |
| ---- | ----------- | ------------------------------------------------------- |
| 401  | 7           | המפתח חסר, פגום או לא מוכר.                             |
| 401  | 10          | המפתח מושעה. כתבו אל <support@amodb.dev>.               |
| 402  | 36          | תוקף המסלול שלכם פג. שלמו עבור תקופה חדשה בעמוד התמחור. |

ראו [שגיאות](https://amodb.dev/he/errors/) לכל הקודים.

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

### האם כותרת Bearer בטוחה יותר מ-api_key בשאילתה?

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

### כמה מפתחות אפשר ליצור?

עד 10 מפתחות פעילים לכל חשבון. כולם חולקים את קצב הבקשות של המסלול שלכם, ולכן מפתח שני לא מוסיף קיבולת.

### מה קורה למפתחות שלי כשאני מחליף מסלול?

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

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

- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.
- [מגבלות קצב](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/acceptable-use/): מה מותר ומה אסור לעשות עם amodb: לבנות אפליקציות, אתרים, בוטים ומחקר על הנתונים, אבל לא לשתף מפתחות, למכור גישה גולמית, לעקוף מגבלות או לתקוף.

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