קבלת מפתח API

התיעוד של amodb

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

עודכן צפייה כ-Markdown

הבקשה הראשונה
bashjspyphpgo 
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const data = await res.json();
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
data = res.json()
<?php
$ch = curl_init("https://api.amodb.dev/3/movie/550?language=en-US");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("AMODB_KEY")],
]);
$data = json_decode(curl_exec($ch), true);
req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/550?language=en-US", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()

var data map[string]any
json.NewDecoder(res.Body).Decode(&data)

כתובות בסיס

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

מתחילים כאן

  • מדריך למתחילים

    בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.

  • אימות

    איך שולחים את מפתח amodb: api_key בשאילתה, כותרת Authorization Bearer או apikey בקריאות OMDb. פורמט המפתח, שמירה, החלפה ושגיאות 401 שכדאי להכיר.

  • מגבלות קצב

    amodb מגביל כל מפתח לפי בקשות לדקה בחלון נע של 60 שניות: 20, 40 או 120 בהתאם למסלול שלכם. קראו את כותרות מגבלת הקצב וטפלו ב-429 עם Retry-After.

מושגים

  • שגיאות

    כל שגיאה של amodb עם סטטוס HTTP, status_code והודעה של TMDB, וגם מבנה השגיאה של OMDb. מה כל אחת מהן אומרת ומה הלקוח שלכם צריך לעשות כשהיא מופיעה.

  • שפות

    amodb מגיש כותרים, תקצירים ושמות ב-14 שפות. העבירו בפרמטר language תגית בסגנון TMDB כמו ru-RU או pt-BR; כל תגית אחרת חוזרת לאנגלית, בלי שגיאה.

  • תמונות

    טענו פוסטרים, תמונות רקע ותמונות פרופיל מ-img.amodb.dev עם נתיבים וגדלים של TMDB מ-w92 ועד original. בלי מפתח, מטמון ל-30 יום ותבנית כתובת אחת לכולן.

משאבים

  • יומן שינויים

    רשימה מתוארכת של שינויים ב-API של amodb, במארח התמונות img.amodb.dev, במסלולים ובאתר. רשומות חדשות בראש הרשימה, עם מה שהשתנה ומה שאתם צריכים לעשות.

  • סטטוס

    איך בודקים אם amodb פועל: נקודת הבדיקה הציבורית, קודי השגיאה שמעידים על תקלה, ואיך מדווחים על בעיה יחד עם כל הפרטים שאנחנו צריכים כדי לטפל בה.

תיעוד ה-API

כל נקודות הקצה

סרטים

סדרות

אנשים

חיפוש ורשימות

הרחבות של amodb

בסגנון OMDb

מדריכים

כל המדריכים

עוד מדריכים ואינדקסים

  • השוואות בין amodb לאחרים

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

  • מקרי שימוש

    איך צוותים משתמשים ב-amodb לנתוני סרטים וסדרות: קטלוגים, שרתי מדיה, כלי המלצות, בוטים ומחקר, עם נקודות הקצה והמגבלות שכל מקרה צריך כדי לעבוד.