איך עוברים מ-V1 API של Tenor

אם יש לכם שילובים קיימים שמשתמשים ב-V1 API של Tenor, אתם צריכים לפעול לפי השלבים שבדף הזה כדי לעבור ל-V2.

קבלת מפתח API בגרסה 2

פועלים לפי ההוראות בשלב ההגדרה במדריך למתחילים כדי לקבל מפתח API בגרסה 2 ולהחליף את הגרסה 1.

עדכון לדומיינים בגרסה 2

מעדכנים את דומיין ה-API ל-https://tenor.googleapis.com/v2/. גרסה 2 של Tenor API תומכת רק בחיבורי HTTPS. לגבי תוכן, חשוב לוודא שהאפליקציה תומכת בהורדות תוכן מ-https://media.tenor.com ומ-https://c.tenor.com.

לדוגמה, נניח שביצעתם קריאה ל-API לאחד מהדומיינים הבאים בגרסה 1:

  • https://api.tenor.com/v1/search?<parameters>
  • https://g.tenor.com/v1/search?<parameters>

כדי לעדכן את הקריאות ל-V2, משנים אותן ל-https://tenor.googleapis.com/v2/search?<parameters>.

שינויים בנקודת קצה (endpoint)

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

  1. נקודת הקצה של החיפוש של Tenor תומכת עכשיו בחיפוש סטיקרים באמצעות הפרמטר searchfilter.
  2. כוללים את הפרמטרים client_key ו-country בקריאות ל-API.
  3. הפרמטר media_filter מקבל עכשיו רשימה של הפורמטים הרצויים שמופרדים בפסיקים, במקום ספירות מוגדרות מראש.
  4. נקודת הקצה Categories תומכת עכשיו בערכים featured ו-trending לפרמטר type.
  5. ה-API לא תומך יותר בפרמטר anon_id.
  6. כשאין יותר דפים של תוצאות לבקש, השדה next בתגובות של ה-API הוא עכשיו מחרוזת ריקה ולא "0".

בוצעו השינויים הבאים בנקודות הקצה הזמינות:

  1. נקודת הקצה Trending לא נתמכת יותר. במקום זאת, מומלץ להשתמש בנקודת הקצה המומלצת.
  2. נקודת הקצה (endpoint) של GIF עברה מיתוג מחדש ונקראת עכשיו Posts endpoint.
  3. נקודת הקצה Random GIF שולבה בנקודת הקצה Search באמצעות הפרמטר random.

שינויים באובייקט התגובה ובשגיאות