نحوه مهاجرت از Tenor's V1 API

برای ادغام‌های موجود که از Tenor's V1 API استفاده می‌کنند، مراحل موجود در این صفحه را برای انتقال به V2 دنبال کنید.

یک کلید API V2 دریافت کنید

دستورالعمل‌های مرحله راه‌اندازی راهنمای شروع سریع را دنبال کنید تا یک کلید API V2 برای جایگزینی نسخه V1 خود دریافت کنید.

به‌روزرسانی به دامنه‌های V2

دامنه API خود را به https://tenor.googleapis.com/v2/ به روز کنید. Tenor's 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> .

نقطه پایانی تغییر می کند

اکثر پارامترهای نقطه پایانی API نسبت به آنچه در V1 مستند شده است، تغییری نکرده است. چند استثنا قابل توجه وجود دارد:

  1. اکنون Tenor's Search از جستجوی برچسب از طریق پارامتر 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. نقطه پایانی GIF به عنوان نقطه پایانی Posts تغییر نام داده است.
  3. نقطه پایانی Random GIF از طریق پارامتر random در نقطه پایانی جستجو گنجانده شده است.

شی پاسخ و خطا تغییر می کند

  • شیء GIF به Object Response تغییر نام داده است.
  • در Response Object ، زمینه media به عنوان media_formats تغییر نام داده شده است. اکنون مقدار media_formats یک نقشه { CONTENT_FORMAT : MEDIA_OBJECT } است نه آرایه ای از نقشه ها.
  • پیش نمایش تصاویر کوچک محتوا از Media Object برای هر قالب محتوا به قالب خاص خود منتقل شده است. آنها تحت فیلد media_formats در Response Object ارائه می شوند.
  • هنگامی که هیچ نتیجه دیگری در یک شی پاسخ وجود ندارد، فیلد next یک رشته خالی است، "" و نه "0" .
  • کدهای خطای Tenor API به کدهای خطای استاندارد API Google منتقل شده‌اند.