Как мигрировать с API Tenor V1

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

Получить ключ API V2

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

Обновление до доменов V2

Обновите домен вашего 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>

Чтобы обновить вызовы V2, измените их на 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. Конечная точка «Тренды» больше не поддерживается. Вместо неё мы рекомендуем использовать конечную точку «Избранные» .
  2. Конечная точка GIF была переименована в конечную точку Posts .
  3. Конечная точка случайного GIF-изображения была включена в конечную точку поиска посредством random параметра.

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

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