מפתח API של TMDB: מפתח תואם בערך תוך דקה

מפתח תואם TMDB בארבעה שלבים

amodb מוכר מפתחות ל-API שלו, ששומר על הנתיבים ועל ה-JSON של TMDB v3. זה לא מפתח של TMDB והוא לא עובד ב-api.themoviedb.org. מה שמקבלים הוא מפתח באותה צורה, 32 תווים הקסדצימליים באותיות קטנות, שהלקוח שלכם ל-TMDB מקבל אחרי החלפה אחת של כתובת הבסיס.

1. פתחו את עמוד התמחור ובחרו מסלול: 20, 40 או 120 בקשות לדקה. כל מסלול מחזיר את כל הנתונים.
2. היכנסו עם האימייל שלכם. amodb שולח קוד בן 6 ספרות שתקף ל-10 דקות. אין סיסמה.
3. שלמו בכרטיס, ב-Apple Pay או ב-Google Pay עבור 1 עד 24 חודשים. שום דבר לא מתחדש אוטומטית.
4. פתחו חשבון, ואז מפתחות API, וצרו מפתח. העתיקו אותו מיד, כי המפתח המלא מוצג פעם אחת.

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

שימוש במפתח: מחליפים את כתובת הבסיס

משאירים את הקוד שלכם ל-TMDB ומחליפים שני ערכים, את כתובת הבסיס ואת המפתח. שתי דרכי השליחה של המפתח עובדות, api_key בשאילתה וכותרת Authorization: Bearer.

# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"

אותה קריאה עם כותרת Bearer, בשלוש שפות:

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}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);

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,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])

התגובה בנויה כמו ב-TMDB v3:

{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}

קראו את images.secure_base_url מתוך /3/configuration כדי שקישורי הפוסטרים יצביעו ל-img.amodb.dev. תמונות לא צריכות מפתח. עוד על שליחת המפתח בעמוד אימות, וסקירה ארוכה יותר במדריך למתחילים.

מפתח TMDB חינמי ומפתח amodb זה לצד זה

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

מתי מפתח TMDB חינמי מספיק

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

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

שימוש מסחרי ומגבלות

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

המסלול קובע את הקצב. כל תגובה נושאת את X-RateLimit-Limit, את X-RateLimit-Remaining ואת X-RateLimit-Reset, ו-429 מוסיף Retry-After. פרטים בעמוד מגבלות קצב.