Cómo migrar desde la API V1 de Tenor

Para las integraciones existentes que usan la API de V1 de Tenor, sigue los pasos que se indican en esta página a fin de migrar a V2.

Obtén una clave de API V2

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

Actualizar a dominios V2

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

Por ejemplo, supongamos que realizaste una llamada a la API a uno de los siguientes dominios V1:

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

Para actualizar las llamadas a V2, cámbialas a https://tenor.googleapis.com/v2/search?<parameters>.

Cambios en los extremos

La mayoría de los parámetros de extremos de API no cambian con lo que se documenta en V1. Hay algunas excepciones notables:

1. El extremo de búsqueda de Tenor ahora admite la búsqueda de calcomanías mediante el 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 predefinidas.
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 no hay más páginas de resultados para solicitar, el campo next de respuestas de la API ahora es una string en blanco en lugar de "0".

Se realizaron los siguientes cambios en los extremos disponibles:

1. Ya no se admite el extremo Tendencias. En cambio, te recomendamos que uses el extremo destacado.
2. Se cambió el nombre del extremo de GIF por el de Extremo de publicaciones.
3. Se incorporó el extremo GIF aleatorio al extremo de búsqueda a través del parámetro random.

Cambios en el objeto de respuesta y el error

• Se cambió el nombre del objeto GIF al objeto de respuesta.
• En Response Object, el campo media cambió de nombre 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 la miniatura de contenido se han trasladado 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 string vacía, "", en lugar de "0".
• Los códigos de error de la API de Tenor se migraron a los códigos de error de la API estándar de Google.