Как перейти с API Tenor V1

Для существующих интеграций, использующих API Tenor V1, выполните шаги на этой странице, чтобы перейти на V2.

Получите ключ API версии 2

Следуйте инструкциям на этапе настройки в кратком руководстве, чтобы получить ключ API версии 2 для замены вашей версии версии 1.

Обновление до доменов версии 2

Обновите домен API до https://tenor.googleapis.com/v2/ . API Tenor V2 поддерживает только соединения 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>

Чтобы обновить вызовы до версии 2, измените их на https://tenor.googleapis.com/v2/search? <parameters> .

Изменения конечной точки

Большинство параметров конечных точек 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. Конечная точка Trending больше не поддерживается. Вместо этого мы рекомендуем вам использовать рекомендуемую конечную точку .
  2. Конечная точка GIF была переименована в конечную точку Posts .
  3. Конечная точка Random GIF была включена в конечную точку поиска с помощью параметра random .

Объект ответа и изменения ошибки

  • Объект GIF был переименован в объект ответа .
  • В объекте ответа поле media было переименовано в media_formats . Значение для media_formats теперь представляет собой карту { CONTENT_FORMAT : MEDIA_OBJECT } , а не массив карт.
  • Предварительный просмотр миниатюр содержимого был перемещен из объекта мультимедиа для каждого формата содержимого в отдельный формат. Они предлагаются в поле media_formats в Response Object .
  • Когда в объекте ответа больше нет результатов, next поле представляет собой пустую строку "" , а не "0" .
  • Коды ошибок Tenor API были перенесены в стандартные коды ошибок API Google.