Come eseguire la migrazione dall'API V1 di Tenor

Per le integrazioni esistenti che utilizzano l'API V1 di Tenor, segui i passaggi indicati in questa pagina per eseguire la migrazione alla versione 2.

Ottenere una chiave API V2

Segui le istruzioni del passaggio di configurazione della guida rapida per ottenere una chiave API V2 da sostituire alla versione V1.

Aggiornamento ai domini V2

Aggiorna il dominio API a https://tenor.googleapis.com/v2/. L'API V2 di Tenor supporta solo le connessioni HTTPS. Per i contenuti, assicurati che la tua applicazione supporti i download di contenuti da https://media.tenor.com e https://c.tenor.com.

Ad esempio, supponiamo di aver effettuato una chiamata API a uno dei seguenti domini V1:

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

Per aggiornare le chiamate alla versione 2, modificale in https://tenor.googleapis.com/v2/search?<parameters>.

Modifiche agli endpoint

La maggior parte dei parametri degli endpoint API è invariata rispetto a quanto documentato nella versione 1. Esistono alcune eccezioni degne di nota:

1. L'endpoint di ricerca di Tenor ora supporta la ricerca di adesivi tramite il parametro searchfilter.
2. Includi i parametri client_key e country nelle chiamate API.
3. Il parametro media_filter ora accetta un elenco separato da virgole dei formati desiderati anziché enum preimpostati.
4. L'endpoint Categorie ora supporta featured e trending per il parametro type.
5. L'API non supporta più il parametro anon_id.
6. Quando non ci sono più pagine di risultati da richiedere, il campo next delle risposte dell'API ora è una stringa vuota anziché "0".

Sono state apportate le seguenti modifiche agli endpoint disponibili:

1. L'endpoint Tendenze non è più supportato. Ti consigliamo invece di utilizzare l'endpoint in evidenza.
2. L'endpoint GIF è stato sottoposto a rebranding e ora si chiama endpoint Post.
3. L'endpoint GIF casuale è stato incorporato nell'endpoint di ricerca tramite il parametro random.

Modifiche all'oggetto risposta e agli errori

• L'oggetto GIF è stato rinominato Oggetto Risposta.
• Nell'oggetto risposta, il campo media è stato rinominato media_formats. Il valore di media_formats ora è una mappa { CONTENT_FORMAT : MEDIA_OBJECT } anziché un array di mappe.
• Le anteprime delle miniature dei contenuti sono state spostate dall'oggetto multimediale per ogni formato dei contenuti al proprio formato. Vengono offerti nel campo media_formats dell'oggetto Risposta.
• Quando non ci sono più risultati in un oggetto di risposta, il campo next è una stringa vuota, "", anziché "0".
• I codici di errore dell'API Tenor sono stati migrati ai codici di errore standard dell'API di Google.