Cómo migrar desde la API de V1 de Tenor

En el caso de las integraciones existentes que usan la API de Tenor V1, sigue los pasos que se indican en esta página para migrar a la versión 2.

Obtén una clave de API de V2

Sigue las instrucciones del paso de configuración de la guía de inicio rápido para obtener una clave de API de la versión 2 y reemplazar la versión 1.

Actualización a dominios de la versión 2

Actualiza el dominio de la API a https://tenor.googleapis.com/v2/. La API de V2 de Tenor solo admite conexiones HTTPS. En el caso del contenido, asegúrate de que tu aplicación admita descargas de contenido desde https://media.tenor.com y https://c.tenor.com.

Por ejemplo, supongamos que hiciste una llamada a la API a uno de los siguientes dominios de la versión 1:

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

Para actualizar las llamadas a la versión 2, cámbialas a https://tenor.googleapis.com/v2/search?<parameters>.

Cambios en los extremos

La mayoría de los parámetros de los extremos de la API no cambiaron con respecto a lo que se documentó en la versión 1. Existen algunas excepciones notables:

1. El endpoint de búsqueda de Tenor ahora admite la búsqueda de calcomanías a través del parámetro searchfilter.
2. Incluye los parámetros client_key y country en las llamadas a la API.
3. El parámetro media_filter ahora toma una lista separada por comas de los formatos deseados en lugar de enumeraciones predeterminadas.
4. El extremo Categories ahora admite featured y trending para el parámetro type.
5. La API ya no admite el parámetro anon_id.
6. Cuando ya no hay más páginas de resultados para solicitar, el campo next de las respuestas de la API ahora es una cadena vacía en lugar de "0".

Se realizaron los siguientes cambios en los endpoints disponibles:

1. Ya no se admite el extremo Trending. En cambio, te recomendamos que uses el endpoint de Featured.
2. El extremo de GIF cambió su nombre a extremo de Posts.
3. El extremo Random GIF se incorporó al extremo Search a través del parámetro random.

Cambios en el objeto de respuesta y en los errores

• Se cambió el nombre del objeto GIF a objeto de respuesta.
• En el objeto de respuesta, se cambió el nombre del campo media a media_formats. El valor de media_formats ahora es un mapa { CONTENT_FORMAT : MEDIA_OBJECT } en lugar de un array de mapas.
• Las vistas previas de las miniaturas de contenido se movieron del objeto multimedia para cada formato de contenido a su propio formato. Se ofrecen en el campo media_formats del objeto de respuesta.
• Cuando no hay más resultados en un objeto de respuesta, el campo next es una cadena vacía, "", en lugar de "0".
• Los códigos de error de la API de Tenor se migraron a los códigos de error estándar de las APIs de Google.