Como migrar da API V1 do Tenor

Para integrações atuais que usam a API V1 do Tenor, siga as etapas nesta página para migrar para a V2.

Gerar uma chave de API V2

Siga as instruções na etapa de configuração do guia de início rápido para receber uma chave de API V2 e substituir a versão V1.

Atualizar para domínios da V2

Atualize seu domínio da API para https://tenor.googleapis.com/v2/. A API V2 do Tenor só aceita conexões HTTPS. Para conteúdo, verifique se o aplicativo é compatível com downloads de conteúdo de https://media.tenor.com e https://c.tenor.com.

Por exemplo, suponha que você tenha feito uma chamada de API para um dos seguintes domínios da V1:

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

Para atualizar as chamadas para a V2, mude para https://tenor.googleapis.com/v2/search?<parameters>.

Mudanças no endpoint

A maioria dos parâmetros de endpoint da API não mudou em relação ao que está documentado na V1. Há algumas exceções importantes:

1. O endpoint de pesquisa do Tenor agora é compatível com a pesquisa de adesivos pelo parâmetro searchfilter.
2. Inclua os parâmetros client_key e country nas chamadas de API.
3. O parâmetro media_filter agora usa uma lista separada por vírgulas dos formatos desejados em vez de enums predefinidos.
4. O endpoint Categories agora é compatível com featured e trending para o parâmetro type.
5. A API não é mais compatível com o parâmetro anon_id.
6. Quando não há mais páginas de resultados para solicitar, o campo next das respostas da API agora é uma string em branco em vez de "0".

As seguintes mudanças foram feitas nos endpoints disponíveis:

1. O endpoint "Em alta" não é mais compatível. Em vez disso, recomendamos que você use o endpoint "Em destaque".
2. O endpoint de GIF foi renomeado como endpoint de postagens.
3. O endpoint "GIF aleatório" foi incorporado ao endpoint de pesquisa pelo parâmetro random.

Mudanças no objeto de resposta e nos erros

• O objeto GIF foi renomeado como objeto de resposta.
• No objeto de resposta, o campo media foi renomeado como media_formats. O valor de media_formats agora é um mapa { CONTENT_FORMAT : MEDIA_OBJECT }, e não uma matriz de mapas.
• As prévias em miniatura do conteúdo foram movidas do objeto de mídia para cada formato de conteúdo. Eles são oferecidos no campo media_formats do objeto de resposta.
• Quando não há mais resultados em um objeto de resposta, o campo next é uma string vazia, "", em vez de "0".
• Os códigos de erro da API Tenor foram migrados para os códigos de erro padrão da API do Google.