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

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

קניית מפתח V2 API

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

עדכון לדומיינים מסוג V2

יש לעדכן את דומיין ה-API שלך ל-https://tenor.googleapis.com/v2/. ב-Venor V2 API יש תמיכה רק בחיבורי HTTPS. לתוכן, עליך לוודא שהאפליקציה תומכת בהורדות תוכן מ-https://media.tenor.com ומ-https://c.tenor.com.

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

  • 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. נקודת הקצה של הקטגוריות עכשיו תומכת ב-featured וב-trending בפרמטר type.
  5. ה-API כבר לא תומך בפרמטר anon_id.
  6. כשאין עוד דפי תוצאות לבקשה, השדה next של התשובות ב-API הוא עכשיו מחרוזת ריקה במקום "0".

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

  1. אין יותר תמיכה בנקודת הקצה של 'הסרטונים החמים'. במקום זאת, מומלץ להשתמש בנקודת הקצה שמוצגת.
  2. נקודת הקצה ל-GIF עברה מיתוג מחדש כנקודת הקצה של פוסטים.
  3. נקודת הקצה GIF אקראית שולבה בנקודת הקצה לחיפוש באמצעות הפרמטר random.

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